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CHAPTER 1. OVERVIEW 






The following Event Driven Executive system components are 
described in this book t 

• Operator commands to invoke programs and provide other 
system control functions 

• A session lanager to invoke utilities from option menus 

• Data management utilities to maintain disk, diskette, and 

tape data 

• Diagnostic utilities to aid in hardware and software 
debugging 

• Graphics utilities to define, display, and maintain graph- 
ic data 

• Terminal utilities to define and modify terminal control 
information 

• Text editing utilities to enter and edit source data 

• Program preparation utilities for system and application 
program development 

• Messages and codes to aid you in operation of the system 

Each of these components is discussed later in the book in 
detail. A brief description of each follows. 
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OPERATOR COMMANDS 

The operator commands provide functions you can perform at your 
terminal. Commands that require parameters prompt you for 
them. Commands are accessed via the ATTN key of the 4978 or 
4 9 7 9 display terminals or the ESC or ALT MODE key on teletype- 
writer terminals. 

The operator commands and the functions they perform are: 

$A Display loaded program names and locations 

$E Blank a 4978/4979 screen 
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$C Cancel a program 

$CP Change a terminal's partition assignment 

$D Dump storage 

Eject printer page 

Load a program 

Patch storage 

Enter the date and time 

Invoke a user-written routine 
SVARYQFF Set a device offline 
$VARYON Set a device online 
$W Display the date and time 



$E 
$L 
$P 
$T 
$U 



SESSION MANAGER 

The session manager is a menu-driven interface used to- access 
both system functions and your applications through a set of 
predefined full screen menus and their associated procedures. 
See "Chapter 3. The Session Manager" on page 2 7 for a detailed 
description on the session manager. 



UTILITIES 

The utilities are a set of programs that provide productivity 
aids for Series/1 application program development and system 
ma i ntsnance . 

To aid you in using these utilities* the Event Driven Executive 
system provides three ways to invoke the utility programs from 
a terminal: 

• The session manager 

• The job stream processor utility ($JOBUTIL) 

• $L command 
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MESSAG ES AND CODE S 

Wiiile using the Event Driven Executive* you may encounter 
return codes, completion codes, and messages. They are found 
in Chapter 6, Messages and Codes. 
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HARDCOPY FUNCT ION FOR THE 4978/4979 D ISPLAY 

Pressing the PF6 key or the assigned hardcopy key on the 4 978 or 
4979 keyboard causes the entire display (24 lines) to be trans- 
ferred to the designated hardcopy device. (During system 
generation, the TERMINAL statement is used to define the hard- 
copy device.) If the hardcopy device has not been defined or is 
currently busy with another operation, then no action is taken. 
Otherwise, the screen cursor moves to each line as it is print- 
ed, returning to its original position after the page is 
printed. The hardcopy function should not be activated while 
the screen is being changed or when I/O is being directed to the 
screen. Also, while the hardcopy function is in progress, keys 
(such as the attention key, PF keys, or ENTER) should not be 
pressed. Simultaneous operation of I/O and the hardcopy func- 
tion can cause unpredictable results. 

In order to avoid erratic forms control during the hardcopy 
function, it is recommended that the top of forms be set on the 
hardcopy device after the IPL sequence. Also, if the hardcopy 
device is reconfigured using STERMUT1, the number of history 
lines should be set to 0. 
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CHAPTER 2. OPERATOR COMMANDS 






The operator commands provide system control functions you can 
perform at your terminal. The operator commands begin with the 
character $ and are directed to the supervisor. (The commands 
directed to the various utilities are described in "Chapter 4 . 
The Utilities" on page 4 7 for each utility). Commands that 
require parameters will prompt you for them. 

The operator commands and the functions they perform are: 

$A Display loaded program names and locations 

$B Blank a 4978/4979 screen 

$C Cancel a program 

$CP Change a terminal's partition number 

$D Dump storage 

$E Eject printer page 

$L Load a program 

$P Patch storage 

$T Enter the date and time 

$U Invoke a user-written routine 

$VARYOFF Set a device offline 

$VARYOM Set a device online 

$W Display the date and time 
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INVOKING THE OPERATOR COMMANDS 

To invoke the operation commands, press the ATTN key on the 
4978 or 4 9 7 9 (designated attention key on the teletypewriter 
terminal). Then enter the desired command in response to the 
prompting message > from the supervisor. 

Note; If the system includes more than 6 4K bytes of storage, 
the $ A , $ C , $ D , $ L , and $ P functions operate only within the 
storage partition assigned to the terminal. 



ENTERING COMM AND PARAMETER S 

You are prompted for required parameter information, for exam- 
ple, the storage addresses to be displayed by $ D or the name of 
the program to be loaded by $ L . 



Note: In the syntax definitions in this chapter, the 
required fields need not be entered on the same line as the 

command . 



An alternate method for entering the operat 
the single line format. This format allow 



a tor commands is 

„ _.___.„ s you to entnr 

successive fields, separated by blanks, as a single entry. 
This can be done for as many fields as the system can process 
before it must print an informational response. A possible 
e n try using single line format is: 



IW IN 



$L $EDXASM CALCSRC ASMWORK ASMJOB 
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$A - LIST ACTIVE PROGRAMS 

Displays the names and load points of all programs that are 
active within the partition to which the requesting terminal is 
assigned. Programs that were loaded by operator commands 
entered at your terminal are identified by an asterisk. 

Syntax: 



$A 

Required? 
Default : 



None 
None 



o 



No operands are supported. 
Example- Display active programs 



> $A 

PROGRAMS AT 08:14 
IN PARTITION #5 
SSMMAIN 0000 * 
SJOBUTIL 040 * 
$DISKUT1 0500 x 
$C0PYUT1 2600 * 
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Example- Program has $GETMAIN for an overlay area 



> $A 

PROGRAMS AT 09:30:50 
IN PARTITION #5 
SEDXASM 1000 x 
5D00 * 
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$B - BLANK DISPLAY SCREEN 

Blanks or erases the requesting terminal's (4978/4979) screen* 
both protected and unprotected areas. 

Syntax: 



$B 

Required: 

Default: 



None 
None 



No operands are required. 
Example - Blank scrsan 
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$D - DUMP STORAGE 

Dumps the contents of storage in hexadecimal on the terminal. 

Syn t a x « 



$ D or igin,address, count 

Required: origin ^address, count 
Default: None 



V/ 




address 

count 
Example 



Description 

The hexadecimal origin address (the program load 
point) . 

The hexadecimal address in the program at which the 
dump is to start . 

The decimal number of words to dump. 

)ump first 10 words of partition 



> $D 

ENTER ORIGIN: 0000 

ENTER ADDRESS, COUNT: 0000,10 

0000: 6302 6AF6 0000 0000 6C34 6AF2 6C34 6AF2 

0010: 0000 0000 

ANOTHER DISPLAY? N 



o 



Note: No verification checking on input values. 
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$E - EJECT PRINTER 

Causes the 4974 or 4973 printer (defined as $SYSPRTR) to 
advance to the top of the next page a specified number of times. 

Syntax * 



$E 

Required: 

Default* 



n 

None 

Ejects one page 



Operan d Description 

n The number of pages to eject 



Example - Eject page on printer 



> $E 2 

Note* Printer ejects two pages. 






^^jT 
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$L - LOAD PROGRAM 

The $ L command loads a program from disk or diskette and starts 
it. 

Synt a x : 



$ L program ,volume>storage data set(s) 

Required*- program 

Default: volume defaults to IPL volume; storage 
defaults to the amount specified on 
the PROGRAM statement of the program 
to be loaded. 



o 



Operand Description 

program The name of the program being loaded. 

volume The name of the volume where the program being loaded 
is stored. 



storage The total additional storage (in bytes) to be added 
to the end of the loaded program (overrides the STOR- 
AGE = parameter specified in the PROGRAM statement) 

data set(s) Data set(s) to be passed to the program being load- 
ed Cif specified in PROGRAM statement); specify the 
data set(s) in the order the program expects. 



Example - Load a Program and pass a singles data set 



> $L 



PROCESS, EDX003 MYDATA 



o 



This example shows the command and parameters entered in single 
line format. Enter as much of the required information as 
possible on the same input line as the C»L command in order to 
minimize the time the loader is busy. 
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Mote* Wait until the system is initialized before loading a 
program. If your system has timers, the system is initial- 
ized when the 'SET TIME AND DATE USING ST 1 appears (or when 
the time and date are printed). If your system does not have 
timers, the system is initialized when it enters the wait 
state after the storage map has been displayed. 
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$P - PATCH STORAGE 

Allows main storage to be patched online, 
in response to prompting messages. 

Syntax ' 



Enter the patch data 



$ P origin *addr ess, count 

R e C4 u i r e d •* origin »address»count 
Default: None 






Gper and Descr.i pt ion, 

origin The hexadecimal origin address (program load point). 

address The hexadecimal address in the program at which the 
patch is to start, 

count The decimal number of words to patch. 



Example - Patch word X'100 1 of program loaded at to X'FFFF 



> <s p 

ENTER ORIGIN: 0000 

ENTER ADDRESS , C OU N" 
0100: CA62. 
DATA: FFFF 
ANOTHER PATCH? H 



010C1 






N o t & * He verification checking of input values. 



C !i a p t €: r 2 . Operator C o m m a n d s 
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$T - SET DATE AND TIME 

Enters a new date and time into the system and resets the real- 
time clock. You can only use $T from terminals having the label 
$SYSLOG and $SYSLQGA. After entering the time, the timer is 
started at the instant carriage return/ENTER is pressed. This 
resets the seconds to zero. 

Notes : 

1. Make sure your time and date entry is correct as the system 
does not verify this data. 

2. If $T is entered from other than $SYSLOG or $SYSLOGA, it is 
equivalent to entering $W. 

Syntax: 



$T date, time 

Required.* date, time 

Default: date defaults to 00/00/00 
time defaults to 00:00:00 



o 



Op e r rind D escriptio n 

date The current date 
time The current time 
Example - Set date and time 



> $T 

DATE(M.D.Y): 8:22:79 

TIMECH.M): 11:15 



o 
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$U - INVOKE YOUR OWN OPERATOR COMMAND 

The U command allows you to write your own operator commands. 
To do this you must link-edit a module with an entry ' $ U S R C M D ' 
into the supervisor before EDXINIT. 

Example - Writing an Operator Command 





PROGRAM 


MAIN=NO 




ENTRY 


$USRCMD 


SUSRCMD 


PRINTEXT 

ENDATTN 

END 


'$U ENTERED' 



Assemble your program and link it to the supervisor. Next> IPL 
the system, press the ATTN key, and enter $ U . The message $U 
ENTERED will appear on your terminal. 






o 
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SVARYOFF ~ SET DEVICE OFFLINE 

Sets the status of a disk, diskette, diskette magazine unit, or 
tape drive to offline. 

On the 4966 diskette magazine unit, each diskette volume in 
individual diskette, slots or either of the diskette magazines 
can be set to offline. 

When you vary a tape device offline, that tape drive is rewound 
to the load point and set logically offline. 

Synta x *- 



$VARYOFF 

Required' 

Default*. 



i o d a slot 
i oda 
None 



Operand Desc r i pt i on 

iod® The hexadecimal device address of the device to be 
varied offline. 

slot The slot number of the diskette to be varied offline? 
This parameter applies to the 4 9 66 only. The valid 
slot numbers are* 








1 

2 

3 
A 



All diskettes ( 1 , 2 , 3 , A , B ) 

Slot 1 

Slot 2 

Slot3 

Magazine 1 

Magazine 2 



\J 
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Operator Commands 



Examples: Vary offline the volume in slot 2 of a 4966 device at 
address 22 



> $VABYOFF 22 2 

IBMIRD OFFLINE 



Vary offline tape drive at device address 4 C on which a stand- 
ard label tape volume (volume serial 123456) was mounted and is 
displayed. 



> $VARYOFF 4C 

12 3456 OFFLINE 



o 



Vary offline tape drive at device address 4 E . In t h i s example, 
the tape drive was defined for non-labeled (NL) tapes or for 
bypass label-processing ( B L P ) , Therefore, the tape ID 
assigned to that device at system generation is displayed. 



> $VARYOFF 4E 
TAPE1 OFFLINE 



If you vary offline a tape drive that is online and in use, you 
are prompted as follows: 



DEVICE MARKED IN USE, CONTINUE? (Y,N): 



o 



If response is N, the tape is not varied offline. If response 
is Y, the tape will be put logically offline (closed) and 
usable (ready to be varied online). This allows an "unclosed" 
tape drive to be recovered. 



Chapter 



Operator Commands 
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SVARYON - SET DEVICE ONLINE 

Sets the status of a disk, diskette, diskette magazine unit, or 

tape drive to online. 

On the 4966 diskette magazine unit, each diskette volume in the 
individual slots or either of the diskette magazines can be 
independently set to online. Nhen a new diskette volume is 
mounted, the diskette volume must be online for it to become 
accessible. I/O commands issued to disk or diskette will not 
operate unless the device and/or the diskette volume is online. 

The first OVARYON after powering up the 4966 may have to be done 
twice, since it may get an I/O error. Also, the 4 966 door must 
be shut to $VARYON the device. 

Before I/O commands can be issued to a tape, the tape must be 
mounted on a tape drive and varied online. 

$ V A R Y N performs special tape functions, depending on the 
label type that is defined for the tape drive. 

♦ If the drive is defined for a standard label (SL) tape, the 
V0L1 volume label is read. 

• If the drive is defined for a non-labeled (NL) tape, the 
leading tape mark (if one exists) is automatically 
bypassed or, if a label is encounted, terminates without 
setting the tape online. 

* If the drive is defined for bypass label-processing (BLP), 
no initial tape motion occurs. 

$ V A R Y N also allows access to a multiple-file tape volume 
through a specified file sequence indicator. 

The tape drive must be set to the proper density at system 
generation or by the Change Tape (CT) command of the $TAPEUT1 
utility before you vary a tape online. You can request that the 
expiration date on an SL tape data set be ignored. 



o 
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CHAPTER 4. THE UTILITIES 



T h e utilities are a set of programs supplied with the Event 
Driven Executive system that allow you to interactively commu- 
nicate with the system and perform many functions necessary for 
Series/1 application program development and system mainte- 
nance . 



INVOKING THE UTILITIES 

To aid you in performing utility functions, the Event Driven 
Executive system provides three ways to invoke the utility 
programs from a terminal: 






The session manager - You choose the desired utility 
program from a predefined option menu provided. Most util- 
ities can be invoked in this manner. This is the easiest to 
use for interactive utilities because you need only enter 
option numbers (not program names) to access the function 
needed. 



SJOBUTIL - The job stream processor utility can be used to 
invoke a predefined sequence of program preparation utili- 
ties and pass parameters to them. SJOBUTIL can itself be 
invoked by the session manager. 



$ L command - Enter the operator command £ L (Load program)* 
followed by the name of the utility of your choice. All 



u t i 1 i t i e s 
manner . 



described in this book can be invoked in this 



o 



Most utility programs are used interactively from a terminal. 
After a utility program is invoked, you can list its defined 
operations and command codes by entering a question mark in 
response to the 'COMMAND (?):' prompt. 

Utilities can be invoked via virtual terminal support. Refer 
to Chapter 14 of the System Guide for details of loading a util- 

ity from a virtual terminal. 



Chapter 4 . The Utilities 
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SUGGESTED UTILITY USAGE T ABLE 

The following table is intended to help you find the appropri- 
ate utility program and command to perform the function that 
you want to accomplish. To use it, find the activity and func- 
tion that you want to do in the left columns; the corresponding 
utility and command to accomplish the function are in the right 
columns. The program name indicated can be used on the $ L 
command to load that utility program. When using the session 
manager, the menu option corresponding to the program name on 
the secondary option menu c * # be selected to access the 
program. The command indicated is used to direct the utility 
to perform the desired function. 



w 
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CV - Copy Volume 

The CV command allows you to copy entire volumes, providing a 
volume backup capability. A disk volume may be copied to 
another disk volume, a diskette volume to a n other diskette 
volume, or a diskette volume to a preallocated disk data set of 
appropriate size in records, as follows: 



Number of Records 

Type 



at 128 Bytes/Sector 



Diskette 1 
Diskette 2 



949 
1924 



vy 



Volume copy operations do not add the members in a source 
volume to the target volume; the original contents of the 
target volume are replaced, including the directory. 

If you have two or more 4 964 Diskette units, or a 4964 and a 
4066 Diskette Magazine unit, diskette volume copies between 
diskette devices are possible. If you have a single diskette 
drive and disk, diskette volume copies can be performedusing 
the following procedure: 



4% 



1. Allocate a target data set on disk of appropriate size. 

2. Using the CV command, copy the diskette volume to the disk 
data set . 

3. Mount the target diskette on the diskette device and vary 
online. 

4. Using the CV command, copy the contents of the disk data 
set to the target diskette. 

If you have a single 4966 Diskette Magazine unit and a disk, the 
above procedure is also recommended. 
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CV EXAMPLE 

Copy A Diskette To A Backup Data Set On 4962 Disk 



COMMAND (?): CV 

COPY VOLUME 

ENTER SOURCE VOLUME: IBMEDX 

ENTER TARGET VOLUME: EDX002 

ENTER TARGET DATA SET NAME - DATA1 

ARE ALL PARAMETERS CORRECT? Y 

COPY COMPLETE 

949 RECORDS COPIED 

COMMAND (?): 



The CV command copies the entire diskette volume. Therefore* 
the target data set should be of equal or greater size than the 
diskette size in records. If the target data set is not large 
enough* you may choose to do a partial copy or allocate (using 
$DISKUT1) a target data set large enough to accomodate the 
source . 






If the target data set is not large enough, you are prompted 
f o 1 lows : 



as 



SOURCE DATA SET HAS nn RECORDS 
TARGET VOLUME HAS ONLY nn RECORDS 
DO YOU WISH TO CONTINUE? CY/N): 



If you respond Y , the source is copied to the target data set 
until the target is full. If you respond N , the CV command ends 
and you are pr omptedfor another command, COMMANDC?):. 

Note! Once you have copied a volume to a target disk volume, 
the original contents of the target volume are replaced, 
including the directory. As a result, the original contents 
of the target disk are no longer accessible. 

Not si See the Sy st em Gu i de for an explanation of disk and 
diskette organization. 



o 
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RE - Copy from Basic Exchange 

The RE command copies a basic exchange data set from a diskette 
to a disk data set, A basic exchange data set is contained on a 
diskette that was formatted for the Standard for Information 
Interchange. Only one-sided, 128-byte diskettes can be used 
because EDX recognizes only one volume on a diskette. The 
target disk data set must be alloc- a ted using SDISKUTi before 
using the RE command. 

You are prompted for the source diskette data set name and 
volume, the target disk data set name and volume, and the basic 
exchange data set name. 

RE EXAMPLE 

Copy Entire Basic Exchange Diskette Data Sat To Disk: 



o 



COMMAND (?): RE 

SOURCE ($$EDXV0L, VOLUME) : $$EDXVOL , IEMEDX 
TARGET (NAME, VOLUME) : DATAFI LI, EDX002 

SPECIFY START/END? Y/N : N 

ENTER BASIC EXCHANGE DATA SET NAME: DATA 
NUMBER OF RECORDS COPIED: 52 
COPY COMPLETED 

COMMAND (?): 



o 
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COPY BASIC EXCHANGE DATA SET TO DISK: In this example, the 
record number where the copy is to start on target disk is spec- 
ified. 



COMMAND (?): RE 

SOURCE ($$EDXVOL, VOLUME) : $$EDXVGU IBMEDX 
TARGET (NAME, VOLUME) : DATAFIL1, EDX002 

SPECIFY START/END? Y/N : Y 
FIRST RECORD: 10 



ENTER BASIC EXCHANGE DATA SET NAME: 
NUMBER OF RECORDS COPIED: 151 
COPY COMPLETED 

COMMAND (?): 



DATA 







You are prompted for the source disk data set name and volume, 
the starting or ending records, the target diskette data set 
name and volume, and the basic exchange data set name. 
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WE EXAMPLE 

Copy A Disk Data Set To A Basic Exchange Diskette 



COMMAND (?): UE 

SOURCE (NAME, VOLUME) : DATAFIL1, IBMEDX 

SPECIFY START/END? Y/N: N 

TARGET ($$EDXVOL, VOLUME) : $$EDXVOL, BASIC 

ENTER BASIC EXCHANGE DATA SET NAME: DATA 
COPY COMPLETE 

COMMAND (?): 



o 



Copy a Disk Data Set to a Basic Exchange Diskette: In this 
example, the beginning and ending records numbers on disk to be 
copied to the target diskette are specified. 



COMMAND (?).: WE 

SOURCE (NAME, VOLUME) : DATAFIL1 , EDX002 

SPECIFY START/END? (Y/N): Y 

FIRST RECORD: 100 

LAST RECORD: 150 

TARGET ($$EDXV0L, VOLUME) : $$EDXV0L, IBMEDX 

ENTER BASIC EXCHANGE DATA SET NAME: DATA 
COPY COMPLETE 

COMMAND (?): 



o 



Notes: 

1 . Errors may occur if the diskette contains uninitialized 
HDRls. Data on the diskette is read and written two 
sectors per I/O operation. 

2. The diskette data set accessed must start on an odd sector 
boundary . 
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SC0PYUT1 - COPY DA TA SET WITH ALLOCATION 

$COPYUTl performs several related copy functions. These func- 
tions determine the size and organization of the source data 
set to be copied, allocates a member on the target volume, and 
then copies the source member to the target member. 

Caut -i on : If a member already exists on the target volume, it is 
deleted, reallocated, and the new source copied to the target 
volume. There are no prompting messages asking if you wish to 
replace the existing member. 



Note: For any copying related to tape, see "STAPEUT1 
Management" on page 311. 



Tape 



$COPYUTI COMMANDS 



The commands available under SC0PYUT1 are listed below. To 
display this list at your terminal, enter a question mark in 
response to the prompting message COMMAND (?):. 



COMMAND (?): ? 



CM — - 


-COPY MEMBER FR 

Mill TTPI C rnp 




nUL 1 If Lt LUr 


CALL- 


--COPY ALL MEMB 


CAD— 


--COPY ALL DATA 


CAP — 


--COPY ALL PROG 


CG- — 


--COPY ALL MEMB 


CNG-- 


--COPY ALL MEMB 

C kf n nc Hill TTD 




tnJJ Ur iiULIlr 


SQ- — 


--SET PROMPT MO 


NQ--- 


--RESET PROMPT 


— CA- 


— WILL CANCEL 


CV — • 


-CHANGE SOURCE 


EN — - 


-END PROGRAM 


? 


-HELP 



OM SOURCE TO TARGET 

Y COMMANDS 

ERS FROM SOURCE TO TARGET 

MEMBERS FROM SOURCE TO TARGET 
RAMS FROM SOURCE TO TARGET 
ERS STARTING WITH TEXT FROM ... 
ERS NOT STARTING WITH TEXT FROM ... 

LE COPY COMMANDS 

DE FOR ALL MULTIPLE COPY COMMANDS 
MODE FOR ALL MULTIPLE COPY COMMANDS 
MULTIPLE COPY COMMANDS 
AND TARGET VOLUMES 



COMMAND C?): 






After the commands sre displayed, you are again prompted with 
COMMAND (?):. You respond with the command of your choice (for 
example, CM). 
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The following commands modify the way the multiple copy 
commands work; if needed, they must be entered before you start 
a multiple copy function. 

SQ You are asked if you want to copy the current member. 

NQ No questions are asked. All matched members are copied. 
This is the default. 

The following keyboard function is invoked with the ATTENTION 
key. (It is not a command.) 

CA If entered, CA stops the multiple copy after the current 
member is copied. 

When SCOPYUTl is loaded, the source and target volumes are set 
to the IPL volume. You can then change the source and target 
volumes. Once the volumes are set, the copy commands copy 
members from the source volume to the target volume until you 
do a CV to change a volume. 



o 



The C G (copy generic) and CNG (copy not generic) commands 
prompt you for a text string. The source volume directory is 
then searched for names beginning with this text string. Use 
CG to copy only those members beginning with the text string. 
Use CNG to copy only those members that do not begin with the 
text string. 



If the multiple copy commands stop because the target volume is 
full, you can mount a new volume and continue the copy. Thus, 
you can create a disk backup spanning several diskettes. The 
actual copy process may take longer than with the utility 
$MOVEVOL, but may use fewer diskettes as only members are 
copied. In addition, single and double-sided diskettes can be 
intermixed. 

Since 0COPYUT1 deletes a member if it already exists, the 
multiple copy functions run faster if the target volume does 
not contain the same member names. If you are creating a new 
volume, use SINITDSK to start with an empty target volume. 



o 



The multiple copy commands will not copy the supervisor ($EDX- 
NUC). This prevents the inadvertent loss of a tailored super- 
visor. Furthermore, since the supervisor is allocated when the 
disk is initialized, the CM command will not allocate $EDXNUC 
on the target volume. It will copy $ E D X N U C from source to 
target but only if the size of $ E D X N U C on the target is the same 
size as on the source. 
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No absolute record copy from disk or diskette is provided. 
Therefore the special names $$, $$EDXLIB> $$EDXVOL are not 
allowed. The $ C Q P Y utility provides an absolute copy by record 
number . 
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$C0PYUT1 



EXAMPLE 






^^^ 



> $L $C0PYUT1 
$C0PYUT1 



35P, 11 : 16:57, LP = 6900 



** WARNING ** 
MEMBERS ON TARGET VOLUME WILL BE DELETED. 
REALLOCATION AND COPYING OF MEMBERS IS 
DEPENDENT ON SUFFICIENT CONTIGUOUS SPACE. 

THE DEFINED SOURCE VOLUME IS EDX003, OK ? Y 

THE DEFINED TARGET VOLUME IS EDX003, OK ? N 

ENTER NEW TARGET VOLUME*. MIKES 

MEMBER WILL BE COPIED FROM EDX003 TO MIKES OK? 

COMMAND (?): CM 

ENTER FRQM(SOURCE) MEMBER: COFFEE 

ENTER TO (TARGET) MEMBER OR * FOR 

COMMAND (?) : CM LEM « 

LEM COPY COMPLETE 10 RECORDS 

COMMAND (?): CG 



SAME NAME AS SOURCE 



COPIED 



ENTER GENERIC TEXT: MIKE 
MIKEEDIT COPY COMPLETE 
MIKEANL COPY COMPLETE 
MIKEDATA COPY COMPLETE 



54 RECORDS COPIED 
13 RECORDS COPIED 
50 RECORDS COPIED 



MIKENAME TOO LARGE TO COPY, ONLY 92 RECORDS 
TARGET VOL IS FULL, DO YOU WISH TO CONT ON A 
MOUNT NEW VOLUME AND DO A $VARYON 
THEN ENTER ATTN RESTART TO CONTINUE COPY 

> $VARYGN 2 
EDX001 ONLINE 

> RESTART 



LEFT IN LIB 
NEW VOL?: Y 



THE DEFINED TARGET VOLUME 
VOLUME NOT MOUNTED 
ENTER NEW TARGET VOLUME: 
MIKE1 COPY COMPLETE 
COMMAND(?): SQ 
COMMANDC?): CALL 
COPY TEMP ? Y 
TEMP COPY COMPLETE 
COPY EDITWORK ? H 
COPY DATAFILE ? Y 
DATAFILE COPY COMPLETE 
COMMAND (?): 



IS MIKES, OK ? Y 



EDX001 

100 RECORDS 



COPIED 



40 RECORDS COPIED 



110 RECORDS COPIED 
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SDASDI - FORMAT DISK OR DISKETTE 

$ D A S D I initializes your 4962 or 4963 disk or formats diskettes 
on the 4964 or 4966 diskette units. The utility can be used 
online. When this utility is invoked* you are prompted for one 
of the following disk or diskette initialization options? 

• Option 1 - 4964* 4966 diskette initialization. 

• Option 2 - 4 962 disk initialization 

• Option 3 - 4963 disk initialization 

$DASDI must be loaded into partition 1. 

Caut i on ** F or disk initialization* a program that accesses the 
disk being initialized should not be run concurrently with this 
utility. 

Diskette initialization can run concurrently with other 
programs . 

OPTION 1 - 4964, 4966 DISKETTE INITIALIZATION 






Diskette Formats 

The $ D A S D I utility reformats single and double -sided 
diskettes. Three formats are available? 

1 . Format for use with the Series/1 Event Driven Executive 

2. Format to the IBM Standard for Information Interchange 

3. Format entire diskette to 128* 256* or 512 byte records. 

If you select the Event Driven Executive format* all tracks are 
formatted for 128 byte sectors. Also* cylinder is formatted 
according to the IBM Standard for Information Interchange. The 
assigned volume label is IBMEDX. 

Note: Use this format if all cylinders are to be formatted 
to 128-byte sectors. 

If you initialize according to the IBM Standard for Information 
Interchange, Cylinder is formatted for 128-byte sectors* and 
the remaining cylinders are formatted for either 1 2 8 - * 256-* or 
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$DEBUG 



D EBUG USAGE CONSIDERAT IONS 

The program debug facility aids in testing mult i tasked 
programs in a multiprogramming and multiuser environment. All 
of your interactions are via terminals and do not require the 
use of the machine console. A summary of the major features of 
the $DEBUG program follows: 

Notes: 



O 



3. 
4. 



To debug a program that uses a 4 973 or 4979 terminal in 
static screen mode* load the program (througn $DEBUG) from 
another* different terminal that the program will use in 
static screen mode. 

$DEBUG should be invoked from a terminal other than the one 
used by the program to be tested if the program uses 
4978/4979 terminals in static screen mode. 

Multiple breakpoints and trace ranges can be established. 

Several users can each use separate copies of $ D E B U G 
concurrently, if sufficient storage is available. 

Series/1 assembler language as well as Event Driven 
Language instructions can be traced and tested. 



6. Both supervisor and application programs can be debugged. 

7. Task names are automatically obtained from the program to 
be tested . 

8 . Task registers #1 and #2 can be displayed and modified. 

9. Hardware registers RO through R7 and the IAR can be 
displayed and modified. 

10. Task registers #1 and #2 can be displayed and modified. 

11. Five different data formats are accepted by the list and 
patch functions. 

12. No special preprocessing of a program is required to permit 
it to be debugged. 



o 



13. All address specifications are made as shown in the program 
assembly listing without concern for the actual memory 
addresses where the program is loaded into storage for 
testing. 
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14. No processing overhead is incurred unless the hardware 
trace feature is enabled. Even then, the hardware trace 
feature is only enabled for specific tasks. 

15. The debug facility can be activated for a program that is 
experiencing problems but was previously loaded without 
the debug facility. 

16. A program can be debugged by loading $ DEBUG from a terminal 
other than the one from which the program to be tested was 
loaded . 



17. Breakpoints or trace 
s e s s i o n can be listed. 



ranges specified during a debug 



18. 



$DEBUG can control the execution of programs containing up 
to 20 tasks. 



The SDEBUG program can be used to test different types of 
programs. The most common usage is to debug application 
programs written using the Event Driven Language instruction 
set. However, it can also be used to test portions of applica- 



tion programs that are written in 



sembler language and 






portions of the supervisor program that are written in either 
Event Driven Language or Series/1 assembler language. Testing 
of the supervisor should normally be required only if you are 
making your own modifications or additions to this program. 

You can use $ D E B U G to debug overlay programs by loading the 
primary program that will subsequently load the overlay 
program to be debugged. Load $ D E B U G after the overlay program 
is in storage. (For more information on debugging overlay 
programs that are part of the Event Driven Language compiler, 
$EDXASM, refer to the Internal Design To suspend execution of 
the overlay program so that $ D E B U G can be loaded, enter a READ- 
TEXT or QUESTION as the first instruction of the overlay 
program. Multiple Terminal Manager users should code a CALL 
ACTION instruction to provide the required function. When the 
overlay program is entered, it pauses at the first instruction 
and waits for input. At this point, load $ D E B U G . This can be 
done from another terminal assigned to the same partition. 
Specify the over lei y program name when prompted for the program 
name a n d indicate that no new copy of the overlay program is to 
be loaded . 
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The $ D E B U G utility can then be used to set breakpoints and 
perform other functions as required. If the overlay program 
causes a program check, it is cancelled by the system. If an 
overlay program terminates through a PROGSTQP or for any other 
reason and is reloaded by the primary program, any breakpoints 
or patches made prior to the termination are lost. 

Use of certain capabilities of $ D E B U G requires a thorough know- 
ledge of both the supervisor and debugging techniques. For 
example, altering the contents of storage locations occupied 
by the supervisor or contents of the Series/1 hardware regis- 
ters could have undesirable effects on the operation of the 
supervisor or application programs in operation concurrently 
with SDEBUG. 



o 



Note: Only those instructions that execute as part of a task 
can be debugged. Those portions of the supervisor program 
that service interrupts created by various hardware devices 
(disk, timers, terminals, etc) cannot be executed under 
control of $DEBUG. 



START AND TERMINATION PROCEDURE 



The primary method for activating the debug facility is to load 
$ D E B U G and then specify the name of the program to be tested, 
when prompted (DBUGDEMO in the following example). SDEBUG then 
loads your program, inserts a breakpoint at the first executa- 
ble instruction, and notifies you that your program is stopped 
at this point. For example: 



> $L $DEEUG 

$DEBUG 26P,09: 10: 17, LP=5200 

PROGRAM NAME: DBUGDEMO 

DBUGDEMO 4P, 09:10:28, LP=6700 

DBUGDEMO STOPPED AT 009E 
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$DEBUG 

SDESUG COMMANDS 

The following commands are available 



AT 


- Set break 


BP 


- List brea 




thus far 


END 


- Terminate 


GO 


- Activate 


GOTO 


- Change ex 


HELP 


- List debu 


LIST 


- Display s 


OFF 


- Remove br 


PATCH 


- Modify s t 


POST 


- Post an e 


PRINT 


- Direct ou 


QUALIFY 


- Modify b a 


WHERE 


- Display s 



points and trace ranges 
kpoints and trace ranges 
specified 

debug f ac i 1 i ty 
stopped task 
ecution sequence 
g commands 
torage or registers 
eakpoints and trace ranges 
orage or registers 
vent or process interrupt 
tput to another terminal 
se address 
tat us of all tasks 



How to Enter a Command 

A command is entered by pressing the ATTENTION key on your 
terminal and entering the command name* or the command name 
plus the required parameters for the command* in response to 
the prompting message ' > T . 



Syntax Summary 

In the command syntax examples and descriptions in the follow- 
ing sections* keyword parameters are capitalized and variable 
parameters are shown in lower case. Whenever one of several 
keywords can be chosen* these keywords are separated by a 
slash (/). The examples show the various formats of each 
command which are available for different purposes. Detailed 
syntax descriptions are presented under $ DEBUG Comma nd 
Descriptions. 









86 



SC34-0313-2 



^B^^^^ 

^^F 



SEDIT and $EDIT1N 



SAVE - SAVE WORK DATA SET: SAVE writes the current contents of 
the work data set to a host data set with the host related 
version ($EDIT1) or to a Series/1 data set with the native 
related version ($EDIT1N). 

If a data set has been previously specified (e.g., in a READ 
command), you are asked if you wish to write onto that data set; 
otherwise, you are prompted for a new data set name. 

S ynta x : 



SAVE 



dsname 



Required: None 
Defaults: None 
Alias: S , SA 



o 



O perand Descripti on 

dsnsma When using $EDIT1, you are prompted for the target 
host data set name. It must be a fully qualified data 
set name. 






EXAMPLE 



When using $ E D I T 1 N , the target data set must have 
been previously allocated in a volume on a 5eries/l 
disk or diskette. The data set should contain fixed 
length records, 80 bytes in length. You sre prompted 
for the target volume name. 
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TABSET - SET TABS: TABSET reestablishes tab values or nulli- 
fies existing tab values. The tabulation character and tab 
stop values sre maintained as part of your work data set. (They 
can be changed later). 

The tab character can be entered anywhere in the data line 
under the INPUT subcommand or line editing function. It causes 
a skip to the next tab position when the data line is entered 
into the work data set. The resulting line is not visible, but 
can be displayed if desired, 

Synta x : 



TABSET 
TABSET 
TABSET 

R e q u i r e d ' 
Defaults : 
Alias: 



0K ! ( integer-list) 

OFF 

CM (tab-character) 



ON, OFF, 

None 

TA 



or CH 



\. P 



Operand Description 

i nteg&r-li st The relative column positions in each line to 
which tab values are to be set. Initial system 
defaults are 10, 2 0, 4 Q > and 72. 

tab-character A new tab character. The standard is a percent 
sign. 

OFF Resets relative tab column positions to initial 
system defaults. Does not reset tab character. 
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OPTION 5 - SUBMIT: The SUBMIT option injects a job (JCL and 
optional data) into the host job stream. The display and oper- 
ation are similar to the READ and WRITE commands. The data set 
name entered must be the fully qualified name of the host data 
set containing the JCL to be submitted. If the keyword DIRECT 
is entered instead of a data set name, the contents of the work 
data set are transferred directly into the host job stream. 
The SUBMIT to host requires the Host Communications Facility on 
the System/370 . 

Note: The DIRECT option is only to be used in systems with a 
HASP or JES2 interface. 

OPTION 6 - LIST: The LIST option prints the entire contents of 
the work data set on the hardcopy device assigned to the termi- 
nal. (The listing can be terminated at any time by pressing the 
ATTN key and typing CA.) 



o 



OPTION 7 - MERGE: The MERGE option merges all, or part, of a 
source data set into the current edit work data set. You are 
prompted for the names of the Series/1 source data set and 
volume. If the specified data set is found, you are then 
prompted for the first and last line numbers of the data to be 
copied. You are also prompted for the line number of the 
current work data set after which the data is to be added. 



MERGE DATA FROM 



(NAME, VOLUME) : 

ADD 



TO 



LINES- 1ST LAST 
TARGET AFTER LINE #: 



o 



Note: Always enter the leading zeros when specifying line 
numbers; for example, specify line 000010 rather than line 
10. 
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If the entire data set is to be merged* an 
instead of the line number specifications. 



can be entered 



The specification of an asterisk is only to be used for the 
source data set. (If the format of the line number specifica- 
tions is incorrect* an error message is displayed and you are 
prompted for another section.) If all parameters are correct? 
the data is then read from the source data set* added to the 
current work data set and the current work data set is renum- 
bered . 

To cancel the MERGE function, press the ENTER key when prompted 
for MERGE FROM data set name. 



Notes 



Once the merge has started* it must be allowed to complete 
normally or unpredictable results may occur. Series/1 
source data sets are defined to consist of 80 character 
lines which are numbered in columns 7 3-80. 



When READ or MERGE functions are processed* line numbers 
are resequenced. This may cause sequence numbers to differ 
if they are not created by $FSEDIT. 






m. W 
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$FSEDIT 



This page intentionally left blank. 



o 



o 
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OPTION 8 - END: The END option terminates SFSEDIT. 

OPTION 9 - HELP: The HELP option displays tutorial text on the 
use of $FSEDIT. 



PRIMARY COMMANDS 

Primary commands are entered on line 2 of the display in the 
Command Input Field. All primary commands can be entered while 
in edit mode. In browse mode* three primary commands are 
recognized by SFSEDIT: LOCATE, FIND, MENU. 

Most of the primary commands can be entered in abbreviated 
format. Only the first character is required. Minimum free 
form format is indicated with each command enclosed in (). 



The function of each of the 
the following pages. 



primary commands is described on 



df 
\ 



\, 
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$ IMAGE 



EDIT MODE 

When you enter edit mode, the current image is displayed within 
a rectangular frame whose upper lefthand corner is at line , 
indent 0. The frame and all screen positions outside it are 
protected in the display buffer; this limits the cursor to 
positions within the frame when the field-advance key is 
pressed. If the image dimensions do not allow display of the 
entire frame* then its sides 3re omitted according to the 
following priority: top before bottom, left before right. 

Null characters, dimension fields, and tab settings should be 
defined before entering edit mode. If you are modifying an 
existing screen image, the null character must be redefined 
each time $ IMAGE is invoked. 

Once the image is displayed, you can invoke the edit phases by 
means of the PF keys. 



I 1 



PF1 This key causes the protected fields of the image to be 
displayed as no n - protected, so you can redefine them 
directly on the screen. The non -protected (data) fields 
of the image are indicated with the null representation 
character, and you use that character to redefine those 
fields if desired. Once this edit phase has been entered, 
PF1 acts as the horizontal tab key and PF2 as the 
vertical, is' hen the ENTER key is pressed, the newly 
defined image is displayed, with protected fields in 
their proper mode. 



To save all non-protected (null) characters from all 
fields when additional non-protected fields have been 
created, depress the ENTER key to exit PF1 mode. Then 
depress the PF2 key and the ENTER key again. To display 
all the non-protected fields with the null characters, 
you may now reenter PF2 mode. 

PF2 This key prepares the IMAGE program for modification of 
the data (non-protected) fields of the image. The cursor 
is displayed at position (0,0) of the image, and you can 
use the field-advance keys to move to each data field in 
turn, or the tab keys (PF1 and PF2) can be used when appro- 
priate. When the ENTER key is pressed, the new data 
values are saved, but not yet written to disk. 

PF3 This key is used to return from edit mode to command mode. 



Vk^g^ 



Note: The ENTER key must have been used for PF3 to 
function correctly. 
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$INITDSK 

SINITDSK - INITIALIZE OR VERIFY VOLUME 

$INITDSK initializes and/or read verifies a Series/1 direct 
access storage device volume for use with the Event Driven 
Executive. 

SINITDSK performs the following functions: 

• Initialization (I) 



Initializes a library directory for 
Driven Executive 



the Event 



— Writes IPL text on a disk or diskette* if desired. The 
IPL device address for 4962 disk* 4 963 disk* 496 4 disk- 
ette* and 4966 diskette magazine units are hexadecimal 
03* 48* 2 * and 22* respectively. An initialized disk- 
ette can be used to IPL from either a 496 4 or 4966 disk- 
ette device. 

— Writes a volume label on a diskette. 

Note: A label is not required on a disk since it is 
not a removable device. 

Verification (V) verifies the readability of: 

— A group of records within a disk or diskette volume 

— A disk or diskette volume 

— All disk volumes at a specified address 

Writes (W) only IPL text on a primary volume for which 
SEDXNUC has been allocated. 



$INITDSK COMMANDS 

The commands available under $INITD5K are listed below. To 
display this list at your terminal* enter a question mark in 
response to the prompting message COMMAND (?): 
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COMMAND (?): ? 

E - END PROGRAM 

I - INITIALIZE DISK(ETTE) 

V - VERIFY DISK(ETTE) AREA 

W - WRITE IPL TEXT ONLY 

COMMAND (?): 



After the commands are displayed, you are again prompted with 
COMMAND (?):. You respond with the command of your choice (for 
example, I). 



INITIALIZATION 






Directory Creation 

A directory can be created on each volume with OINITDSK. The 
minimum directory size is 2 records. The maximum sizes are 120 
records on a 4 9 62, 4963,, 4964, or 4 966 and 60 records on the 
fixed head volume of a 4 962 or 4963. The maximum volume size, 
including directory, is 32,767 records. The directory size 
determines the maximum number of programs and data sets that 
can be stored. A directory of n records can catalog a maximum 
of 8n-2 data sets. 



o 



Diskette Initialization 

The volume label on a diskette conforms to the standard for sn 
EBCDIC Basic Exchange format. One EBCDIC Header Label (HDR1) 
is written which describes the entire diskette as an allocated 
data set. An entire diskette is considered as an Event Driven 
Executive volume. A single-sided diskette is initialized to 
contain up to a 13-record directory and a 936-record data area. 
A double-sided diskette is initialized to contain up to a 26 
record directory and an 1898 record data area. A diskette must 
have been previously initialized to 128 bytes per sector by 
using the $ D A S D I utility. On a 4966 diskette magazine unit, 
you can initialize only on slot number 1. 
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Disk Initialization 

Each disk volume (primary and secondary) must be initialized by 
using $INITDSK. 

Note: If you initialize and create a directory on disk or 
diskette, any data previously stored on the disk or diskette 
will no longer be accessible. 
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o 



COMMAND (?): AI 

ENTER DEVICE ADDRESS ,(HEX 1 

CONVERT DIAGNOSTIC ZERO ? H 



•FF) 



60 



CONVERTING DIAGNOSTIC VOLTAGE, 
AI VOLTAGE = 4604 MV, E-0 
AI VOLTAGE = 4602 MV, E-0 
> ALTER 
COMMAND (?): 



SHOULD BE 4.5 +- 0.5 



LD - Li st Devi cas 



o 



LD reads the actual hardware addresses, their IDs, and displays 
a list of the descriptions. If a device exists but is not 
powered on, the description for that device is displayed. 



COMMAND (?): LD 

ACTUAL SERIES/1 HARDWARE CONFIGURATION 

00 = TELETYPEWRITER ADAPTER 

01 = 4974 PRINTER 

02 = 4964 DISKETTE UNIT 
04 = 4979 DISPLAY STATION 
09 = SINGLE LINE BSC 

40 = TIMER FEATURE 

41 = TIMER FEATURE 

50 = IDIO DI/PI NON-ISOLATED 

51 = IDIO DI/PI NON-ISOLATED 

52 = IDIO DO WITH EXTERNAL SYNC 

53 = IDIO DO WITH EXTERNAL SYNC 

COMMAND (?): 
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LS - List Supervisor Configuration 

LS provides a display similar to LD except that it lists the 
devices your supervisor supports after system IPL. 



VI - Display Volume Information 

VI displays information about volumes as follows? 



COMMAND (?) : VI 



VOLSER TYPE IODA 



STATUS 



VOLORG VOLSIZE LIBORG 



NRQ021 

NRP001 

SMVOL 

NRP002 

NRP003 

NEWPRG 

FORT 

DEV 

EDX002 

ASMLIB 

SUPLIB 

EDX003 

EDX005 

EDX006 

EDX007 

EDX008 



PRI . 
PRI. 
SEC. 
SEC- 
SEC. 
SEC. 
SEC, 
SEC. 
PRI. 
SEC. 
SEC. 
SEC. 
PRI . 
SEC. 
SEC. 
SEC. 



0002 
0022 
0022 
0022 
0022 
0022 
0022 
0022 
0003 
0003 
0003 
0003 
0048 
0048 
0048 
0048 



1 
2 
3 

1A 

3A 

4A 

10A 



ONLINE 

ONLINE 

OFFLINE 

ONLINE 

ONLINE 

ONLINE 

ONLINE 

ONLINE 

ONLINE (IPL) 



ONLINE 






7 5 


27 





75 


27 





75 


27 


13 


74 


14 


13 


75 


27 





74 


14 


13 


75 


27 





74 


14 





130 


241 


130 


16 


1 


146 


16 


1 


162 


141 


1 





50 


705 


51 


50 


1 


150 


50 


1 


200 


50 


1 






Note* Communication device cards not installed at IPL time 
will not show up as supervisor-supported. 
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4966 Diskette Usage Considerations 

If you are using the 49 6 6 diskette magazine unit for your 
dump/restore operation, you can use diskette magazines or an 
individual diskette slot. If you use an individual diskette 
slot, then all of the subsequent diskettes mounted must be 
placed in the same slot. If you use diskette magazines, you 
must have all of your diskettes in the correct sequence with no 
empty slots in the magazine. The first volume with the suffix 
00 must be in slot number 1 of the first magazine. You can use 
either or both of the diskette magazines, A and B. 



DATA SET SPECIFICATION 

If $M0VEV0L is invoked with the $ L command, you are prompted to 
enter the names of the data sets and volumes to be used. 



o 



Figure 21 shows the parameter menu displayed when $M0VEV0L is 
invoked using the session manager. Enter the requested infor- 
mation and press ENTER. 



$SMM0308: SESSION MANAGER $M0VEV0L PARAMETER INPUT MENU- 
ENTER/SELECT PARAMETERS: DEPRESS PF3 TO RETURN 



DISK 



($$EDXLIB, VOLUME) ==> 



DISKETTE (NAME, VOLUME) ==> 



^WN^r 



Figure 21. $M0VEV0L parameter input menu 
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DUMP PROCEDURE 



The following steps are required 
direct access volume onto diskette. 



to dump the contents of a 



1. Set up a control diskette, 
a. Use $INITDSK to: 



1) Initialize the 
label that is 
5AVE00) . 



control diskette with a volume 
suffixed with 00 (for example. 



2) Create a directory of at least 2 records. 

3) If the diskette is to be used to IPL another 
system, reserve space for a nucleus of the appro- 
priate size and write the IPL text. 

Use $DISKUT1 to: 



1) Determine the directory size, in members, of the 
volume to be dumped. To determine the size in 
records, use the following formula: 

members/8 = records 






Add 1 if you have a remainder. 

2) Change volume to the control diskette (for 
example, SAVE00) and allocate a control data set 
with the same name as the name of the volume to be 
dumped. The member size of the control data set 
must be one record larger than the size of the 
directory of the volume being dumped. 

Use SC0PYUT1 to: 

1) Copy other data sets onto the control data set. 
For example, you may required SEDXNUC, the tran- 
sient loader, or a copy of SMOVEVOL. 

Not a J The first record in the control data set 
contains control information and up to 50 char- 
acters of text describing the data being 
dumped. The remaining space stores a copy of 
the directory of the volume being dumped. 
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Set up a series of data diskettes. For each data diskette: 
a. Use $INITDSK to: 

1) Create a volume label. The volume label of each 
diskette must have the same four-character prefix 
as the control diskette and a two-character suffix 
indicating the sequence number; for example, 
SAVE01, SAVE02, , SAVEnn . 

2) Create an owner ID field. 

3) Allocate a two-record directory. 
Use $DISKUT1 to: 



b. 






1) Allocate a one-record data set named ^CONTROL. 

2) Allocate a second data set with the name of the 
volume to be dumped (for example, EDX002). The 
second data set must use the remaining available 
space on the diskette (9 4 6 records for a 
single-sided diskette and 1921 records for a 
double-sided diskette. 



Mount the control diskette, 
$M0VEV0L for execution. 



vary it online and load 



You must specify two data sets at load time: 

DISK The volume on disk to be dumped. Specify $$EDX- 

LIB> volser . 



DISKETTE 



The control data 
dsna me, volser. 



set 



on 



diskette. Specify 



o 



$MOVEVOL asks if you wish to dump from disk to diskette. 

$M0VEV0L then determines the number of additional disk- 
ettes required to dump the referenced volume (DISK), 
informs you of this requirement, and asks whether the 
procedure should be continued. A negative response termi- 
nates the operation. If the response is positive, the 
control information and disk directory are recorded on the 
control diskette and you sre asked to mount a new diskette 
for transfer of the data portion of the volume being 
dumped. 

Each time a diskette is f i ^led , $MOVEVOL requests another 
diskette. Mount as many data diskettes as requested. 
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EXAMPLE 

Dump Operation Using a 4966 Diskette Magazine Unit 



> $L $MQVEVOL 
DISKCNAME, VOLUME) : $$EDXLIB, EDX002 
DISKETTECNAME, VOLUME) : $EDX002, SAVEOO 

$MOVEVOL 20P, 10:07:52, LP=5200 

DUMP LIBRARY FROM VOLUME EDX002 TO DISKETTE? Y 



) 



PROCESSING DISKETTE VOLUME SAVEOO 
ENTER LIBRARY IDENTIFICATION (1-50 CHAR 
DUMP OF EDX002 - DATE IS 09/14/77 

11 MORE DISKETTES ARE REQUIRED, CONTINUE? 



PROC 
PROC 
PROC 
PROC 
PROC 
PROC 
PROC 
PROC 
PROC 



ESSING 
ESSING 
ESSING 
ESSING 
ESSING 
ESSING 
ESSING 
ESSING 
ESSING 



DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 
DISKETTE 



VOLUME 
VOLUME 
VOLUME 
VOLUME 
VOLUME 
VOLUME 
VOLUME 
VOLUME 
VOLUME 



SAVE01 
SAVE02 
SAVE03 
SAVE04 
SAVE05 
SAVE06 
SAVE07 
SAVE08 
SAVE09 



MOUNT NEXT DISKETTE OR MAGAZINE 
REPLY -Y- WHEN DONE: Y 

PROCESSING DISKETTE VOLUME SAVE10 
PROCESSING DISKETTE VOLUME SAVE11 

VOLUME DUMP OPERATION COMPLETE 
9200 RECORDS TRANSFERRED 

SMOVEVOL ENDED 10:10:13 



,4 "*\ 






298 



SC34-0313-2 



o 



$TAPEUT1 



CD - COPY DATA SET: CD copies a disk or diskette data seb onto a 
tape* copies a tape data set into a disk or diskette data set or 
onto another tape. The command writes a trailer label at the 
end of the data set on the target tape if it is a standard label 
tape. Header labels are not written on standard or non-labeled 
tapes* therefore* the target tape data set must be 
prea 1 located . 

If a disk or diskette data set is being copied to tape* the tape 
records will be 256-bytes. If a tape data set from another 
system (for example* a S/370) is copied to a disk or diskette 
and the source records are not 256-bytes* the source records 
are split into multiple 256-byte records with any unused bytes 
padded with zeros. Prior to copying* you are prompted for the 
maximum input record size. 

Consider the following when you are copying data sets: 



^Ifcw^ 



When you reach a tapemark (end of input data)* you are 
prompted to continue. If you have more records to copy* 
you can continue; however, make sure that there is suffi- 
cient room on the target tape. You sr e prompted at every 
tapemark encountered on the source tape. If you do not 
wish to continue* the trailer label is written on the 
target tape . 






To copy the contents of one tape to another tape* thereby 
creating an exact duplicate of the entire tape (header 
label and data records or only data records)* you can use 
either of two methods: 

— To copy only data records* initialize the target tape 
(using the IT command) so that it has the same label 
type as the source tape. Copy (using the CD command) 
the source tape to the target tape. This allows you to 
create a new header label on the target tape and to 
duplicate only the data records from the source tape. 

— To create an exact duplicate of the source tape* mount 
the source and target tapes on drives specified for 
bypass label-processing. Then copy (using the CD 
command) the entire source tape. The target tape 
becomes an exact duplicate of the source all label 
records, all data records* and all trailer labels). 
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CD EXAMPLES 

Copying Data from a Disk to a Tape (Standard Label Tape) 



COMMAND (?): CD 



SOURCE (NAME 
TARGET (NAME 
ENTER SOURCE 
USE ATTN/CA 



, VOLUME): $TAPEUT1, EDX002 
, VOLUME): DATAilll , 123456 

BLOCKSIZE (NULL=DISK(ETTE) ) 
TO CANCEL COPY 



ARE ALL FARMS CORRECT? 
EOD ON SOURCE DATASET 
25 RECORDS COPIED 

COMMAND (?): 



( Y , N ) 



Copying Data from a Disk to a Tape (Non-Labeled Tape) 



COMMAND (?): CD 

SOURCE (NAME, VOLUME) : X, TAPE 01 
TARGET (NAME, VOLUME) : DATAilll > 123456 
ENTER SOURCE BLOCKSIZE ( NULL=DISK ( ETTE ) ) 
USE ATTN/CA TO CANCEL COPY 



ARE ALL PARMS CORRECT? 
EOD ON SOURCE DATASET 
25 RECORDS COPIED 

COMMAND (?): 



(Y,N) : Y 



M 'TIN 



Note: TAPE 01 i 
generation. 



the ID assigned to the tape drive at system 
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EX - EXERCISE TAPE: EX, a software exerciser, performs two 
operations: 

• It exercises any of the three label type tapes to ensure 
that the I/O commands to that tape are executing correctly. 

• It analyzes the surface of the tape to verify that the 
surface is free of defects. Any errors and their approxi- 
mate location on the tape are printed on the system printer 
($SYSPRTR) . 

Caution: Surface analysis writes records over the information 
currently on the tape. Any existing data records or labels are 
destroyed . 

Each operation is optional and you are prompted before continu- 
i ng . 

The EX command performs the following functions: 

• Writes 600 unique records to a data set on the tape 

• Closes and reopen the data set 

• Finds a particular record within the data using NOTE/POINT 

• Verifies that the correct record is accessed 

• Performs a surface analysis of the tape by writing over the 
tape and then verifies each record. 

If an error is encountered the return code and the contents of 
the buffer are printed. The buffer contains all FFFF's except 
for the last word, which is the record count of the failing 
record . 

Note: if tape exerciser is not successful, do the 
following: 

• turn on error logging 

• Run exerciser again 

• Provide information to your CE 



o 
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EXAMPLE 



COMMAND (?): EX 

TARGET (NAME, VOLUME: MYDATA, 123456 

USE ATTN/CA TO CANCEL THE EXERCISER 

DO YOU WANT TO EXERCISE THE SOFTWARE (Y/N): Y 

Exerciser runs and prints status on printer 

WRITE/READ ENTIRE SURFACE OF TAPE? (Y/N): Y 

Exerciser writes on entire surface of tape, then 
reads and verifies each record 

TAPE EXERCISER ENDED 



A sample of the data printed by the EX command follows. 






\J 
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Restore Disk Device from More than One Tape 



o 



COMMAND (?): RT 

*X-X-X-**X-****XX-**HX-XXH*X*X******X*XX- 

* WARNING: TO ENSURE PROPER * 

* DISK CONTENTS, THE SYSTEM * 

* SHOULD BE INACTIVE WHILE * 

* RUNNING THIS UTILITY * 
x-xxxx-xxxxxxx-xxx-xxxx-x-x-xx-x-x-xxx-x-xx-xx-x- 

SOURCE (NAME, VOLUME) : SAVE1,TAPE02 
TARGET (NAME, VOLUME) : $$EDXVOL, EDX002 
DEVICE RESTORE? Y 
ARE ALL PARMS CORRECT? (Y,N): Y 

USE ATTN/CA TO CANCEL THE RESTORE 

MOUNT SAVE2,TAPE02 

REPLY Y WHEN TAPE MOUNTED AND VARIED ONLINE? 

> $VARYON 4D 

TAPE02 ONLINE 

? Y 

DISK RESTORED 

COMMAND (?): 



mLxJr 



Note: If a tape error is encountered during a device 
restore, the utility informs you of the error and tells you 
which disk track corresponds to the bad tape record. The 
utility then attempts to resume processing. Once the 
restore has ended, the disk contents must be verified. Some 
tape errors can cause an indeterminate read head position in 
relation to the actual tape records, thereby displacing 
data on the disk. 
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ST - SAVE A DISK DEVICE OR DISK VOLUME ON TAPE: ST saves an 
entire disk device or a single disk volume on a tape. ST 
prompts you to specify whether you sre saving a device or 
volume. The ST command can be used in conjunction with the 
restore command (RT) to backup data you wish to protect. 

EXAMPLES 

Save Disk Volume on Tape 



> $VARYON 4C 

TAPE01 ONLINE 

> $L STAPEUTl 

$TAPEUT1 19P, 00:06:26, LP= 7A00 
TAPE01 DUAL NL 1600 ONLINE 

DEVICE ADDRESS = 004C 
TAPE02 SL 1600 OFFLINE 

DEVICE ADDRESS = 004D 

COMMAND (?): ST 

* WARNING: TO ENSURE PROPER * 

* TAPE CONTENTS, THE SYSTEM * 

* SHOULD BE INACTIVE WHILE * 

* RUNNING THIS UTILITY. * 
xxxxxxxxxxxxxxxx*x*xxxxxxxx*xxxx 

SOURCE (NAME, VOLUME) : $$EDXVOL, ASMLIE 

TARGET (NAME, VOLUME) : X,TAPEQ1 

DEVICE SAVE? H 

VOLUME SAVE OF ASMLIB ONTO TAPE X,TAPE01 

K ? ( Y , N ) : Y 

USE ATTN/CA TO CANCEL THE SAVE 

VOLUME SAVED 
COMMAND (?): 






u 
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If no options are selected, because you entered only a carriage 
return/ENTER in response to the select option message, the 
defaults are LIST on $SYSPRTR using the language control data 
set $ E D X L on the volume ASM LIB. If a listing is required on 
another device, specify LIST or L. You can enter the name of 
the device in response to the prompt for device name or on the 
same line. Enter an asterisk (*) to specify your terminal. 



If no listing is required, specify NOLIST or N . In this case, 
the compile statistics are printed on the same terminal as 
$ E D X A S M was loaded from. If only statements containing errors 
are to be printed, specify ERRORS or ER. In this case, a device 
name is required as in LIST. Similarly, an asterisk ( * ) indi- 
cates that the error messages are to be listed on the loading 
terminal. This option is very useful for the first few compi- 
lations to remove typographical or simple syntactical errors 
from the source program. 



O 



If a control data set other than OEDXL on the volume ASMLIB is 
required, enter CONTROL followed by the name and volume of the 
data set to be used. All option entries can be entered on a 
single line or in response to prompt messages. The last 
entered listing option takes precedence. The compilation or 
the subsequent listing can be cancelled at any time by pressing 
ATTN and entering CA. 



© 



$EDXASM OUTPUT 

When the compilation process is complete, the compiler prints 
out statistics. They indicate the source, work, and object 
data sets used, the date and time the compilation started, the 
elapsed time for the compilation, the number of statements 
processed, the number of statements flagged with error 
messages, and the compilation completion code. A completion 
code of -1 is normal. At this time, the object module is stored 
and is ready for input to $ U P D A T E or $ L I N K . If a listing has 
been requested, it is then printed on the appropriate output 
device. The printing of duplicate lines of object code is 
automatically suppressed by the listing routine of $ £ D X A S M . 
Before the data sets specified in the compilation are reused, 
it is possible to request a listing of the compilation using 
the program $EDXLIST. Refer to "SEDXLIST - Compiler Listing 
Programs" on page 370 for more information. 
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EXAMPLES 



LIST on $SYSPRTR: 

SELECT OPTIONS (?): null entry 



ERRORS on PRINTERl: 

SELECT OPTIONS (?): ERRORS 

DEVICE NAME: PRINTERl 
SELECT OPTIONS: END 

or 
SELECT OPTIONS: ER PRINTERl END 



NOLIST and use $EDXL on EDX002: 

SELECT OPTIONS (?): N CONTROL 
CONTROLCNAME, VOLUME) : $EDXL,EDX002 
SELECT OPTIONS (?) : END 






Processing Compiler Output with $UPDATE or $LINK 

The output object module has been completed before the listing 
is started; therefore* the object module can be processed by 
SLINK and /or $ UPDATE while the listing is being produced. The 
operation of OUPDATE is described under "SUPDATE - Object 
Program Converter" on page 408. The operation of SLINK is 
described under " $ L I N K - Linkage Editor" on page 390. 



m m 
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Convert Existing ■Program* Thr<t is Mot a Program Type Member 



COMMAND (?): RP 

OBJECT MODULE NAME: PROGX 

OUTPUT PGM NAME: PR0G2 
ILLEGAL HEADER FORMAT 

COMMAND (?): 



^I^^r 



Note: No action is taken when error occurs. 

Convert Program Where Existing Output Data Set is Not Program 
Type 



COMMAND (?): RP 

OBJECT MODULE NAME: OEJSET 

OUTPUT PGM NAME: TSTPROG 
TSTPROG IS NOT A PROGRAM 
COMMAND (?): 



^fc|j» 



Note: No action is taken when error occurs. 
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$ UPDATE 



V> 



Convert and Replace Existing Output Program with Same Output 
Name: In this example* if the existing output program is to be 
replaced with the new output program and the new and old sizes 
are the same, then the new program data replaces the old with no 
other changes. If the new space required is different from the 
existing space, the existing data set is deleted and a new one 
of the proper size is allocated wherever enough free space is 
available. 



COMMAND C?): RP 

OBJECT MODULE NAME: OBJSET 

OUTPUT PGM NAME: TSTPRG1 

OUTPUT PGM NAME: TSTPRG1 
TSTPRG1 REPLACE? Y 
TSTPRG1 STORED ON EDX002 

COMMAND (?): 






o 
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$UPDATE 



o 



Convert and Rename New Output Program if an Output Program 
Already exists: The existing output data set is undisturbed 
and a new data set Ctype PGM) of the proper size and with the 
new name is allocated. 



o 



COMMAND (?): RP 

OBJECT MODULE NAME: OBJSET 

OUTPUT PGM NAME: TESTPROG 
TESTPROG REPLACE? N 
RENAME? Y 

NEW PGM NAME: TSTPRG 
TSTPRG STORED ON EDX002 

COMMAND (?): 



End $UPDATE 



COMMAND (?): EN 

$UPDATE ENDED AT 11:39:34 
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INVOKING $UPDATE 



Invoking ^UPDATE Using $JOBUTIL 

Whan $UPDATE is invoked as part of a batch job under the control 
of SJGBUTIL* certain restrictions apply to its operation. In 
this mode* the command is assumed to be RP. The Rename function 
is not supported; however* the Replace function is. Refer to 
the preceding examples for a description of Rename and Replace. 

In batch mode> $ U P D A T E terminates its execution after perform- 
ing one RP command. A completion code is set by $ U P D A T E depend- 
ing upon the success or failure of the requested operation. 
This code can be tested by the JUMP command of $JOBUTIL. The 
$UPDATE completion codes are described in Chapter 6* Messages 
and Codes . 



When SJOBUTIL is used to invoke $UPDATE> the information 
required by $ U P D A T E must be passed to it by means of the PARM 
command of $JOBUTIL. The required information consists of: 

1 . The name of the device to receive the printed output 
resulting from $ U P D A T E execution 






2. The name, volume of the data set containing the input object 
module 

3. The name* volume of the data set to contain the output load- 
able program 

4 . An optional parameter YES if the output module is to 
replace an existing module of the same name, volume 

The volume names of the data sets must be given unless they 
reside on the IPL volume. 

The first three items of information <ire required and must be 
given in the order described. At least one blank must occur 
between each of these four items in the PARM command. 

An example of invoking ^UPDATE via $JOBUTIL commands follows: 



%J 
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Messages 



KK* EVENT DRIVEN EXECUTIVE *** 

Issued By : IPL Operation 

Exp 1 anat i on : After $ SYS LOG terminal initialization this mes 
sage appears on the SSYSLOG terminal. 

System Action: None. 

Response : None. 






I/O ERROR INITIALIZATION FIXED HEAD DEV, DISK RETURN CODE= xxx 
IN THE TWO RECORDS STARTING WITH RECORD xxx 

Issued By : Disk Initialization 

Explanation? An error was encountered during fixed head 
initialization starting with record xxx. 

System Action: The initialization is terminated. 

Response : Check the Disk return code to find the cause of the 
problem and take the appropriate action. 






INITIALIZATION ERROR 

Issued By : Multiple Terminal Manager 

Expl anation: Initialization was unsuccessful. This message 
is written to the terminal that loaded the Multiple Terminal 
Manager. Additional messages are printed on the Multiple 
Terminal Manager log device. 

System Action: Multiple Terminal Manager terminates. 

Response : Determine the cause of the error and take correc- 
tive action. 
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Messages 



INVALID COMMAND 

Issued By: SIAMUT1 

Exp lanat i on : An invalid command was entered by the user. 

System Action? Reprompts for command. 

Response : Enter a question mark (?) to obtain a list of valid 
commands and try again. 

INVALID PROGRAM NAME 

Issued By t Multiple Terminal Manager 

Exp lanat i on : The name of the program requested from the pri- 
mary menu was not found in the Multiple Terminal Manager pro- 
gram table or invalid parameters were supplied on a 
DISCONNECT command. 

System Action? The requested function is not performed. 

Response : Correct the program name or parameters and retry 
the request . 






INVALID SIGNON CHARACTER 

I ssued By : Multiple Terminal Manager 

Explanation: The SIGNON specification for the TERMINAL file 
record listed immediately before this message is not "Y" or 
"N". 

System Action: The terminal is not connected. 

Resp onse : Correct the TERMINAL record. Stop and restart the 
manager , 



o 
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Messages 



INVALID TERMINAL 

Issued By : Multiple Terminal Manager 

Explanation? The terminal name entered with a DISCONNECT 
command is not a Multiple Terminal Manager terminal. 

System Action? The terminal is not disconnected. 

Response : Retry specifying a valid terminal name. 






KEY OF INPUT REC XXXXXX IS DUPLICATE OR OUT OF SEQUENCE. OMIT 
THE RECORD AND CONTINUE? 

Issued By: $IAMUT1 

Exp lanat i on t A duplicate key exists in the input sequential 
data set and could not be written to indexed data set. 

System Act i on : If reply = Y, the next record will be read from 
input data set and processing continues. If reply = N, com- 
mand term i nates . 

Response : Make sure the input data set contains the proper 
data. Check the KEYSIZE and KEYPOS parameters used to define 
the indexed data set against the input data set records. 
Make sure the data in the input data set is in the proper 
sequence. Redefine and reload data set if necessary. 



o 



LOAD ERROR RC=xxx 

Issued By: Multiple Terminal Manager 
Exp lanat i on : A load failure occurred. 

System Action: The terminal is not available to the Multiple 

Terminal Manager. 

Response : Check the LOAD return code to find the cause of the 
problem and take the appropriate action. 
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LOAD FOR SERVER xxxxxxxx FAILED* RC=xxx 

Issued Bv : Multiple Terminal Manager 

Explanation: A load failure occurred during initialization 
for the ser\ier for terminal xxxxxxxx. 

System Action: The terminal is not available to the &m . . 

Response : Check the LOAD return code to find the cause of the 
problem and take the appropriate action. 



MENUNAME INVALID 

Issued By: Multiple Terminal Manager 

Explanation? The primary menu name specified for the TERMI- 
NAL file record listed immediately before this message is 
invalid. 

System Act i on : The terminal is not connected. 

Response : Correct the TERMINAL record. Stop and restart the 
manager . 






MULTIPLE TERMINAL MANAGER SYSTEM FAILURE 

Issued By: Multiple Terminal Manager 

Exp lanat i on : The Multiple Terminal Manager task error exit 
routine has been entered due to a machine or program error. 

The PSW and LSB at the time of failure has been saved at a 
displacement of X T 172' into the program storage. Register 1 
in the LSB contains the address of the failing instruction in 
the case of a program check. 

The following example shows a specification check which 
occurred at location X ' 5 3 C ' . 
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Messages 



MULTIPLE TERMINAL MANAGER SYSTEM FAILURE > $A 

PROGRAMS AT 00:06:24 IN PARTITION #2 $MTM 0000 * 
CDMSVR33 6C00 > $D 172 30 X 0172: 8002 28E6 0110 10D0 
ODDC 053C ODAC 7361 

0182: 0540 815C 00B8 ODDA 0000 OOFA 0004 0028 

0192: 0052 007C 00A6 0017 0E72 A0A2 0E72 FFFF 

01A2: 0102 8026 1616 40C9 D5C9 E3C9 

ANOTHER DISPLAY? 



The PSW is 8002 at 0172 and Rl is 053C on same line. 

System Act i on : The Multiple Terminal Manager program remains 
active waiting for an event which will not be posted. 

Response : Use Event Driven Executive operator facilities to 
display storage . 



MULTIPLE TERMINAL MANAGER TERMINAL FILE RECORDS 

Issued By : Multiple Terminal Manager 

Explanat i on : The TERMINAL file records processed by the Mul- 
tiple Terminal Manager are listed after this message. Any 
messages pertaining to a specific TERMINAL file record will 
be displayed immediately after the f \ 1 e record. 

System Action: TERMINAL file records processed are listed. 

Response : Review the listing and take action as needed. 



o 
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MTMSTORE DATA SET LIMITS EXCEEDED 

Issued By : Multiple Terminal Manager 

Exp lanat i on : The specified MTMSTORE file is too small. This 
can occur after adding a new program with a storage require- 
ment greater than any previous program's requirement or 
after adding a new terminal or screen. 

System Act i on ' The manager terminates. 

Response : Delete the MTMSTORE file and recreate it with more 
space . 



NO BUFFER SUPPLIED. SIAMUT1 TERMINATING 

Issued By: $IAMUT1 

Explanation: The $STORAGE field in program header was set to 
and no buffer exists for $IAMUT1. 

System Action: The program terminates. 

Response : Use the SS command of $DISKUT2 to set the $STORAGE 
field to the desired buffer size (must be > 0). For L , U N , a n d 
RO commands, this buffer must be large enough to contain the 
entire input and /or output record (whichever is larger). 






NO PROGRAM LOAD FACILITY 

Issued By : Load Utility Program 

Explanation: The load utility program ($L0ADER) cannot be 
found on the IPL volume. 

System Act ion: The Load utility is terminated. 

Response : If $L0ADER is not on the IPL volume, you must copy 
$L0ADER from XS-3001 to the IPL volume and restart the Load 
utility. 



o 



440 



SC34-0313-2 



TNL SN34-0762 (December 15, 1981) to SC34-0313-2 






Messages 



NO TERMINALS ARE AVAILABLE 

Issued By : Multiple Terminal Manager 

Explanation? No valid terminal specification records were 
found in the TERMINAL file, or, no terminal servers can be 
loaded, or, all terminals are busy. Other messages generated 
indicate the problem area. 

System Action: The manager terminates. 

Response ' Determine the cause of the problem and take correc- 
tive action. 






NO TRAP CONDITIONS SPECIFIED. 
$TRAP TERMINATED 

Issued By: $TRAP Utility 

Explanat i on : No trap conditions were specified. Some are 
required. 

System Act ion: The STRAP utility is terminated. 

Response : Specify the necessary trap conditions and restart 
the STRAP utility. 



o 



NULL INVALID FOR PARAMETER 

Issued By: SIAMUT1 

Explanation: An attempt was made to specify a null response 
(&) to a parameter on which this is invalid. 

System Act i on : Reprompts for parameter. 

Response : Enter the proper response to the parameter prompt. 
See determining data set size and format section in the 
$IAMUT1 chapter of the utilities manual for a description of 
each parameter. A null response is only valid for RSUBCK, 
RSUIX, FPOOL AND DELTHR parms. 
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OPEN FOR LOAD RETURN CODE = xxx. RETRY ?: 

Issued By: $IAMUT1 

Explanation : $IAMUT1 attempted to open the specified IAM 
file in LOAD mode and a bad return code was received from the 
IAM request . 

System Action? If retry = Y> reprompts for DSNAME, VOLUME and 
retries the IAM open request. If retry = N, command termi- 
nates. 

Response : Check the Indexed Access Method return code to find 
the cause of the problem and take the appropriate action. 



OPEN FOR PROCESS RETURN CODE = XXX. RETRY?: 

Issued By: $IAMUT1 

Exp 1 anat i on : $IAMUT1 attempted to open the specified IAM 
file in process mode and a bad return code was received from 
the IAM request . 

System Action? If retry = Y, reprompts for DSNAME, VOLUME and 
retries the IAM open request. If retry = N, the command ter- 
minates. 

Respons e : Check the Indexed Access Method return code to find 
the cause of the problem and take the appropriate action. 



PARTITION NUMBER IS INVALID 

Issued By: $DUMP Utility 

Explanation: An invalid partition number was entered during 
a partial storage dump. 

System Action: The $DUMP utility is terminated. 

Response : Enter a valid partition number and restart the 
$DUMP uti li ty. 



o 
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PRIMARY MENU mmmmmmmm FAILED FOR TERMINAL tttttttt 

Issued By? Multiple Terminal Manager 

Exp lanat i on : A SETPAN function failed for the terminal 
tttttttt using the primary menu mmmmmmmm. 

System Action? The primary menu is not displayed. 

R esponse : Ensure that a valid menu name is specified in the 
TERMINAL file for the specified terminal. 






PROGRAM AREA TOO SMALL TO HOLD PGM pppppppp 

Issued By: Multiple Terminal Manager 

Explanation: The manager's program area is too small to hold 
the named program. 

System Action: The program is not used. 

Response: Increase the program area size by reallocating 
CDMDUMMY or split the program into smaller link-edited pro- 
grams . 



o 



PROGRAM CAPACITY EXCEEDED 

Explanation: 

The amount of working storage allocated to $ V E R I F Y is insuf- 
ficient to process the indexed data set specified. 

System Action: 

SVERIFY terminates. 

Response : 

Increase the amount of working storage available to OVERIFY. 
Refer to Modifying Working Storage Requirements for a 
description of how to calculate the amount of working storage 
required and how to modify the amount supplied. 
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PROGRAM FILE LARGER THAN PROGRAM MANAGER BUFFER 

Issued By : Multiple Terminal Manager 

Exp lanat i on : The program table built during initialization 
exceeds the size of the buffer used by the program manager. 

System Action: Multiple Terminal Manager terminates. 

Response : Increase the program manager buffer size in module 
CDMCOMMN. 



PROGRAM LOAD ERROR 

Issued By : Multiple Terminal Manager 

Explanation: An Event Driven Executive LOAD error occurred 
for the requested program. 

System Action: The program is not loaded. 

Response : Determine the cause of the problem. Rebuild the 
program if the problem persists. 






PROGRAM xxP>00.00.00, LP=zzzz 

Issued By : Program Load 

Exp lanat i on : Any program invoked using $L (Load a Program) 
results in this message being displayed, indicating that the 
program you requested has been loaded. Here, xxP indicates 
that the program is xx pages long (256 bytes equals one 
page). 00.00.00 is the time in hours, minutes and seconds. 
LP=xxxx indicates that the load point of the program is at 
location X'zzzz'. If the timer support is not included in 
the supervisor, the time is not printed. 

System Action: None. 

Response : None . 



o 
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READ INPUT DATASET RETURN CODE = XXX. RECORD NUMBER = XXXXXX 

Issued By: $IAMUT1 

Explanation* An attempt to read the indexed input data set 
failed for a sequential data set. 

System Act i on : Command terminates. 



Response : LO command - check the 
find the cause of the problem 
action. UN, RO commands -check 
return codes find the cause of 
appropriate action. 



READ/WRITE return codes to 
and take the appropriate 
the Indexed Access Method 
the problem and take the 



o 



RECONNECT SYNTAX INVALID 

Issued By* Multiple Terminal Manager 

Explanation: The correct syntax was not used on the RECONNECT 
operator command. 

System Action: The command is ignored. 

Response : Retry the RECONNECT command with correct syntax. 



o 



RECONNECT TERMINAL DEFINITION ERROR 

Issued By : Multiple Terminal Manager 

Exp lanat i on : The RECONNECT operator interface facility has 
encountered a failure while attempting to reconnect a termi- 
nal to the Multiple Terminal Manager. Since initialization 
would have already performed all functions necessary to 
include the terminal in the terminal table, the TERMINAL 
file, SCRNS volume or source table in RECONNEC has probably 
been altered since the Multiple Terminal Manager was 
started . 

System Act i on : Terminal is not connected. 

Response : Determine the cause of the error (check TERMINAL 
file for correct data). 
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SCREEN TABLE LARGER THAN INPUT BUFFER 

Issued By : Multiple Terminal Manager 

Exp lanat i on : The screen table built during initialization 
exceeds the Input Buffer size. 

System Act i on ' Initialization is aborted. 

Response » Increase the Input Buffer size in module CDMCOMMN. 



SENSOR I/O DEVICE AT ADDRESS XXXX IS OFFLINE 
BSCA NOT THE DEVICE AT ADDR: zzzz 

Issued By.' Sensor I/O Status Check 

Exp lanat i on : The system checks the status of any defined sen- 
sor I/O or Binary Synchronous Communications Adapter devices 
and prints appropriate status messages. 

System Action: None. 

Response ? None. 






SET DATE AND TIME USING COMMAND $T 

Issued By ; System 

Explanat i on ? If timer support was included during system 
generation, the system prints a message indicating that the 
date and time can be optionally entered (or reset) using the 
$T supervisor utility. 

System Action? None . 

Response t None. 
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SIGNON PROGRAM NOT AVAILABLE FOR TERMINAL tttttttt 

Issued By: Multiple Terminal Manager 

Explanation* The specified terminal is required to sign on 
and off but no program named SIGNON was found in the PRGRMS 
vol ume . 

System Action: The terminal is not signed on. 

Response : Place a program named SIGNON in the PRGRMS file or 
designate that no signon is needed for the specified 
terminal. Reconnect terminal. 



TAPE xxxx IS NOT A TAPE * * * 
TAPE xxxx MARKED UNUSABLE 

Issued Bv ' Tape Initialization 

Explanation? If an address is incorrectly defined (for exam- 
ple, the device is not a tape), if the tape drive is not 
turned on, or if the tape drive has a hardware failure, mes- 
sages describing the problem are issued. 

System Action? The initialization is terminated. 

Response? Correct the problem and restart the 
initialization. 



TAPE xxxx OFFLINE FOR BLP yyyy BPI 

Issued Bv : Tape Initialization 

Explanation: If the address (yyyy) is valid and the tape is 
not mounted this message is printed. 

System Action: The initialization is terminated. 

Response: Mount the tape and restart the initialization. 



■ 1 
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TAPE xxxx TAPE01 ONLINE FOR BLP yyyy BPI 

Issued By : Tape Initialization 

Exp 1 anat i on : If the address (yyyy) is valid and the tape is 
mounted this message is printed. 

System Action: None . 

Response : None. 



TERMINAL tttttttt BUSY 

Issued By : Multiple Terminal Manager 

Explanat i on : Terminal tttttttt specified in the TERMINAL 
file is connected to another program. 

System Action: The terminal is not used. 

Response: Try to RECONNECT at a later time. 






TERMINAL tttttttt NOT DEFINED IN EVENT DRIVEN EXECUTIVE SYSTEM 

Issued By : Multiple Terminal Manager 

Exp lanat i on : The specified terminal was not included in the 
definition of terminals when the Event Driven Executive sys- 
tem was generated. 

System Ac t i on : The terminal is not connected. 

Response : Include a terminal definition for the specified 
terminal when the Event Driven Executive system is 
generated . 



o 
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TERMINAL tttttttt RECONNECTED 

Issued Bv : Multiple Terminal Manager 

Explanat i on ? The named terminal has been reconnected to the 
Multiple Terminal Manager. 

System Action? The terminal is reconnected to the Multiple 
Terminal Manager. 

Response ? Use the terminal as needed. 



o 



TERMINAL NAME INVALID 

Issued By? Multiple Terminal Manager 

Exp lanat i on ? The terminal name specified for the TERMINAL 
file record listed immediately before this message is inval- 
id. 

System Action? The terminal is not connected. 

Response ? Correct the TERMINAL record. Stop and restart the 
manager . 






TERMINAL TABLE OR STORAGE SIZE EXCEEDED 

Issued Bv ? Multiple. Terminal Manager 

Explanation? While building the terminal table and loading 
servers, the storage size or the the maximum number of termi- 
nals (10) allowed has been exceeded. The work space, defined 
in CDMINIT, is defined to allow a maximum of 50 terminals. 

System Act i on ? The extra terminals are not connected. 

Response ? Increase the terminal table size by changing mod- 
ule CDMCOMMN. If there is not enough room, make the parti- 
tion larger, decrease the number of terminals, or make 
CDMDUMMY smaller. 
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VALUE OUT OF RANGE 

Issued By: $IAMUT1 

Exp lanat i on t An invalid value was entered for the parameter 
prompt . 

System Action: Reprompt for parameter. 

Response ' Enter the proper response to the parameter prompt. 
See Determining Data Set Size and Format section under 
OIAMUTl chapter of Utilities manual for a description of each 
parameter . 



VERIFICATION COMPLETE, ERROR(S) ENCOUNTERED 

Exp lanat i on : 

$ VERIFY has completed normally. 

System Ac t i on t 

$ V E R I F Y terminates. 

Response ' 

Examine any reports printed as needed. 
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WARNING: NO FSE IN SOURCE DIRECTORY POINTS TO END OF VOLUME. 
EXTRA DISK SPACE IN TARGET WILL NOT BE ADDED TO SOURCE VOLUME 
DEFINITION. 

Issued by: $TAPEUTl (RT) 

Explanation? You are restoring a volume where the disk target 
volume is larger than the tape source volume definition. The 
utility attempted to update the disk volume directory to 
reflect the additional available space. However, to do so one 
free space entry must point to the end of volume. The addi- 
tional space will be added to that FSE. In this case, no FSE in 
the directory pointed to the end of volume. 



\ tt y' 



System Action: The utility terminates. 

Response : The disk volume is useable, except that the addi- 
tional space cannot be accessed. To recover the additional 
soace, the original volume must be saved again. Before saving 
it, you must compress it. Then run this utility again. 

WARNING? I/O ERROR ACCESSING DIRECTORY. RC= XXX EXTRA DISK 
SPACE IN TARGET WILL NOT BE ADDED TO SOURCE VOLUME DEFINITION 

Issued by: $TAPEUT1 CRT) 

Explanation: You are restoring a volume where the disk target 
volume is larger than the tape source definition. An I/O error 
was encountered while the utility was attempting to update the 
disk volume directory to reflect the added space available. 

System Action: The utility terminates. 



Response : The disk volume directory may be only partially 
updated and therefore unuseable. Delete the volume and 
re-allocate it in a different spot on the disk and run the util- 
ity a g a i n . 
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WRITE OUTPUT DATASET RETURN CODE = XXX. RECORD NUMBER = 
xxxxxx. 

Issued By: $IAMUT1 

Explanation? An attempt to write to a sequential (output) 
data set failed. 

System Action' Command terminates. 

Response ? L0> RO commands - Check the Indexed Access Method 
return code to find the cause of the problem and take the 
appropriate action (N0TE1). UN command - Check the 
READ/WRITE return code to find the cause of the problem and 
take the appropriate action (N0TE2). 

NOTE 1 ? It may be necessary to redefine data set (SE,DF) and 
retry LO command. 

N0TE2 ? It may be necessary to reallocate the data set and 
retry the UN command. 



xxxxxxxx DISCONNECT 

Issued By' Multiple Terminal Manager 

Exp lanat i on ? Terminal xxxxxxxx has been issued a successful 
DISCONNECT command. 

System Action? The terminal is disconnected. 

Response ? Reconnect terminal as needed. 



*Jd kJ 



xxxxxxxx PROGRAM TYPE INVALID 

Issued By? Multiple Terminal Manager 

Explanation? Program xxxxxxxx in the PRGRMS volume is not a 
program type data set. 

System Action? The program named is not used. 

Response ? Specify program type members only for use as pro- 
grams . 
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xxxxxxxx SCREEN SIZE TOO LARGE 

Issued By ' Multiple Terminal Manager 

Exp lanat i on : Screen xxxxxxxx in the SCRNS volume will not fit 
in the screen manager buffer. 

System Action: The screen is not available during this Multi- 
ple Terminal Manager session. 

Response : Increase the screen manager buffer size in 
CDMCOMMN. 






xxxxxxxx SETPAN FAILED, RC=xxx 

Issued By: Multiple Terminal Manager 

Explanation: A SETPAN failed for the screen named xxxxxxxx. 

System Act i on : Processing continues. 

Response : Check the Multiple Terminal Manager return code to 
find the cause of the problem and take the appropriate 
act i on . 
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PROGRAM CHECK ERROR MESSAGE 



If a program 
message with 
terminal: 



check occurs during execution of a program, a 
the following format is printed on the $SYSLOG 




Where: 

PLP The program load point of the failing program. 

TCB The location of the task control block for the failing 
program (the address appearing on the assembly listing). 

PSW The processor status word when the check occurred 
(described under Procesor Status Word). 

LSB Level status block, consisting of the following: 



x 



y 



WORD 1 
WORD 2 
WORD 3 
WORD 4 



- 11 - 



instruction address register 
address key register (AKR) 
level status register (LSR) 
general registers (R0-R7) 



If the program is written in assembler language, COBOL, 
FORTRAN, or PL/1, the contents of the registers depend upon the 
conventions unique to that language. If the program is written 
in Event Driven Language, registers through 7 (words 4-11) 
conta i n : 



o 

^*» 



Jr 
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WORD 


4 - 


(RO) 


WORD 


5 - 


(Rl) 


WORD 


6 - 


(R2) 


WORD 


7 - 


(R3) 


WORD 


8 - 


(R4) 


WORD 


9 - 


(R5) 


WORD 


10 - 


(R6) 


WORD 


11 - 


(R7) 



work register 

address of Event Driven Executive 

i nstr uct i on 

address of EDL TCB 

address of EDL operand 1 

address of EDL operand 2 

EDL command 

work register 

work register 



The program in which the error occurred is either aborted or, 
if it has a task error exit, the exit is entered. In either 
case, normal system execution is resumed after the program 
check message has been printed. Program check in EDL command 
interpreter may cause Rl to be invalid. 






SYSTEM PROGRAM CHECK ERROR MESSAGE 

If a program check occurs in the supervisor, 
message prints on the SSYSLOG terminal: 



the following 



SYSTEM PGM CHK: PSW AND LSB 

8000 0000 1014 80DP 6F00 6F22 1015 54F5 6F26 805C 



WORD 1 

WORD 2 

WORD 3 

WORD 4 



- 11 - 



- processor status word (PSW) 

- instruction address register (IAR) 

- address key register (AKR) 
level status register (LSR) 



PROCESSOR STATUS WORD 



o 



The processor status word (PSW) is used to record error or 
exception conditions in the system that bey prevent further 
processing. It also contains certain status flags related to 
error recovery. Error or exception conditions recorded in the 
PSW cause four of the possible seven class interrupts to occur. 
These are machine check, program check, soft exception trap, 
and power/thermal warning. 
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The Copy Processor Status and Reset (CPPSR) instruction can be 
used to examine the PSW. This instruction stores the contents 
of the PSW into a specified location in main storage. 



The PSW is contained in a 
bit representation? 



16-bit register with the following 



Processor 

Type 495x 

Bit 2 3 5 



Condi ti on 



Class 
Interrupt 



Note 



00 X X X Specification Check 

01 X X X Invalid Storage Addr 

02 X X X Privilege Violate 

03 X X Protect Check 

X Not Used 

04 X X X Invalid Function 



05 X Floating Point 

Except i on 

X X Not Used 

06 X XX Stack Exception 

07 - Not Used 

08 X X X Storage Parity Check 

09 - Not Used 

10 X X X CPU Control Check 

11 X X X I/O Check 

12 X X X Sequence Indicator 

13 X X X Auto IPL 

14 X X Translator Enabled 

X Not Used 

15 X X X Power/Thermal Warning 



Program Check 

Program Check 

Program Check 

Program Check 



Soft Exception 

Trap 

Soft Exception 

Trap 

Soft Exception 
Trap 

Mach i ne Check 

Mac h i ne Check 

Machine Check 

None 

None 

None 

Power/Therma 1 



Notes: 

1 . Always Zero 

2 . Status Flag 

3. Controlled by summary mask 
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Following is an explanation of the bit representations: 

Bit 00 Specification Check : Set to one if (1) the storage 
address violates the boundary requirements of the specified 
data type, or (2) the effective address is odd when attempting 
to execute a floating-point instruction and the floating-point 
feature is not installed. 

Bit 01 Invalid Storage Address : Set to one when an attempt is 
made to access a storage address outside the storage size of 
the system. This can occur on an instruction fetch, an operand 
fetch, or an operand store. 



Bit 02 Pr i v i lege 



Violate : Set to one when a privileged 
in the problem state (supervisor 



instruction is attempted 

state bit in the level status register is not on). 






Bit 03 Protect Check : In the problem state, this bit is set to 
one when (1) an instruction is fetched from a storage area not 
assigned to the current operation, (2) the instruction 
attempts to access a main storage operand in a storage area not 
assigned to the current operation, or (3) the instruction 
attempts to change a main storage operand in violation of the 
read-only control. 

Bit 04 Invalid Function : Set to one by the following 
cond i t i ons : 

1. Attempted execution of an illegal operation code or func- 
tion combination. These are: 



Op code 


Funct 


00101 


All ( 




Rl or 


00111 


All 


01000 


0001 , 


01011 


0001 , 




the r 




i nsta 


01011 


0101 , 


01100 


111 


OHIO 


11000 


11011 


All 


10110 


All 


11101 


1100, 



i on 

when register 7 is specified in the 
R2 field of the instruction) 

0010, 0011, 0101, 0110, 0111 

1001 (when in supervisor state and 

elocation translator feature is not 

lied) 
0111 

, 11010, 11011, 11100, 11110, 11111 



1101, 1110, 1111 



O 



Note: The preceding illegal conditions cause a program 
check class interrupt to occur. 
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2 . The processor attempts to execute an instruction associ- 
ated with a feature that is not installed. These are: 

Op code Function 

00100 All (floating-point feature not installed) 
01011 0011, 1011 (if the floating-point feature 

is not installed and the processor is in 

supervisor state) 

Note: The preceding condition causes a 
soft-exception-trap class interrupt to occur. 

Bit 05 Floating-Point Exception : Set to one when an exception 
condition is detected by the option floating-point processor. 
The arithmetic indicators (carry, even, and overflow) define 
the specific condition. 



Bit 06 Stack Exception : Set to one when an attempt has been 
made to pop an operand from an empty main storage stack or push 
an operand into a full main storage stack. A stack exception 
also occurs when the stack cannot contain the number of words 
to be stored by a Store Multiple (STM) instruction. 

Bit 08 Storage Parity : Set to one when a parity error has been 
detected on data being read out of storage by the processor. 
This error may occur when accessing a storage location that has 
not been validated since power on. 

Bit 10 CPU Control Check : A control check will occur if no lev- 
els are active but execution is continuing. This is a 
machine-wide error. (See I/O check note.) 

Bit 11 I/O Check : Set to one when a hardware error has occurred 
on the I/O interface that may prevent further communication 
with any I/O device. PSW bit 12 (sequence indicator) is a zero 
if the error occurred during an Operate I/O instruction and is 
set to one if the error occurred during a non-DPC transfer. The 
sequence indicator bit is not an error in itself but reflects 
the last interface sequence at any time. An I/O check cannot be 
caused by a software error. (See note.) 

Note: The machine check class interrupt initiated by a CPU 
control check or I/O check causes a reset. The I/O channel 
and all devices in the system are reset as if a Halt I/O 
(channel directed command) had been executed. The process- 
or, sensor-based output points, and timer values are not 



o 
reset . 

Bit 12 Sequence Indicator : 
interface sequence to occur. 






This bit reflects the last I/O 
See I/O check described above. 



o 
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Bit 13 Auto IPL : Set to one by hardware when an automatic IPL 
occurs . 

Set to zero by : 

• A power on reset when Auto IPL mode is not selected 

• Pressing the Load key 

• An IPL initiated by a host system 

Refer to the appropriate hardware manual for a description of 
initial program load. 

Bit 14 Translator Enabled ? When the Storage Address Relocation 
Translator Feature is installed, this bit is set to one or zero 
as f ol lows : 

1. Set to one (enabled) 

• An Enable (EN) instruction is executed with bit 12 of 
the instruction word set to zero and bit 14 set to one 

2. Set to zero (disabled) 

• A Disable (DS) instruction is executed with bit 14 of 
the instruction word set to one 

• An Enable (EN) instruction is executed with bit 12 of 
the instruction word set to one 

• A processor reset (power-on reset, check restart, IPL, 
or system reset key) 

Bit 15 Power Warning and Thermal Warning : Set to one when these 
condition occur (refer to the appropriate hardware manual for a 
description of a Power/Thermal Warning class interrupt). The 
power/thermal class interrupt is controlled by the summary 
mask . 

For a description of class interrupts, I/O interrupts and the 
basic instruction set (including indicator settings and possi- 
ble exceptions conditions) for your specific processor, refer 
to the appropriate hardware manual. 



o 



Chapter 6. Messages and Codes 



459 



TNL SN34-0762 (December 15, 1981) to SC34-0313-2 



Completion Codes 



CODES 

This section presents three types of codes issued by the Event 
Driven Executive: 

Completion Issued by utility programs upon completion to 
indicate if execution was successful or not 



Return 



Issued as the result of executing an Event Driven 
language instruction or subroutine to indicate 
success or failure of the operation 



Post 



Issued by the system to signal the occurrence of an 
event 



The codes and their meanings are presented by type and alpha 
betically by functional grouping. 



Utility Completion Codes 

The completion codes and their meanings are presented in alpha- 
betic order according to function as follows: 

• SEDXASM 
$IAMUT1 
$JOBUTIL 

• $LINK 

$UPDATE 

The utility completion codes are printed on the specified list 
device by the utility programs upon their completion unless 
otherwise noted. 



4 X, 
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Completion Codes 



SEDXASM COMPLETION CODES 

$ E D X A S M completion codes are accompanied by an appropriate 
error message and appear at the end of the OEDXASM listing. The 
completion codes can be tested by the job stream processor, 
allowing steps subsequent to the assembly to be skipped, if 
appropriate. The completion codes are: 



o 



Completion 




Code 


Condition 


-1 


Successful completion - no errors 




in assembly 


8 


Successful completion - one or more 




statements had assembly errors 


12 


Out of space in work or object 




data set 


12 


I/O error in source, work, or 




object data set 


12 


Over lay- i ns t r uct i on table full 


12 


Unable to locate overlay program 




or copy code module 


12 


Location counter error - 




program size exceeds 6 4 K 


100 


Operator cancelled assembly with 




ATTN CA command 



o 
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$IAMUT1 Completion Codes (Part 1 of 2) 



Complet i on 


Code 


-1 


01 


02 


03 


04 


05 


06 


07 


08 


12 


13 


23 


31 


32 


34 


36 


37 


38 


39 


40 


41 


42 


43 


44 


45 


46 


47 


48 


49 


50 


51 


52 


54 


55 



Condi t i on 



Successful completion 

Data set not found (OPEN failed) 

Invalid IODA exit (OPEN failed) 

Volume not mounted (OPEN failed) 

Library not found (OPEN failed) 

Disk I/O error (OPEN failed) 

No VTOC exit address (OPEN failed) 

Link module in use 

Load error for $IAM 

Data set shut down 

Module not included in load module 

Get storage error - IACB 

FCB WRITE error during IDEF processing 

Blocksize not multiple of 256 

Data set is too small 

Invalid block size during file definition 

process i ng 

Invalid record size 

Invalid index size 

Record size greater than block size 

Invalid number of free records 

Invalid number of clusters 

Invalid key s i ze 

Invalid reserve index value 

Invalid reserve block value 

Invalid free pool value 

Invalid delete threshold value 

Invalid free block value 

Invalid number of base records 

Invalid key position 

Data set is opened for exclusive use 

Data set opened in load mode 

Data set is opened, cannot be 

opened exclusively 

Invalid block size during PROCESS or LOAD 

Get storage for FCB error 
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$IAMUT1 Completion Codes (Part 2 of 2) 



Comp let i on 
Code 



Condition 



56 
60 

61 

62 

100 

101 

110 



FCB READ error 

LOAD mode key is equal to or less than 

previous high key in data set 

End of file 

Duplicate key found 

READ error 

WRITE error 

WRITE error - data set closed 
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5J0BUTIL Completion Codes 

The SJOBUTIL completion codes are displayed on the terminal 
used to access SJOBUTIL. The codes are as follows. 



Comp let i on 
Code 



-1 
61 

64 

67 

70 

71 

72 

73 

74 
75 
76 
77 
78 

79 

80 



Condition 



Succes 
The tr 
i nc 1 ud 
No spa 
loader 
A disk 
during 
Not en 
the p r 
Progra 
vo 1 ume 
Disk o 
r ead i n 
Disk o 
progra 
Ref ere 
Ref ere 
Data s 
I n v a 1 i 
LOAD i 
r'equi r 
LOAD i 
requir 
In va 1 i 
exampl 



sf ul complet i on 

ansient loader ($L0ADER) is not 

ed in the system 

ce available for the transient 

or diskette I/O error occurred 

the load process 
ough main storage available for 
ogr am 
m not found on the specified 



while 

while reading 

program 
data set 

vo 1 ume 



r diskette I/O error 

g directory 

r diskette I/O error 

m header 

need module is not a 

need module is not a 

et not found on referenced 

d data set name 

nstruction did not specify 

ed data set ( s ) 

nstruction did not specify 

ed parameter ( s ) 

d volume label specified; for 

e, greater than eight characters 



U ^/ 



G 
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$LINK Completion Codes (Part 1 of 3) 



O 



Comp . 




Cause 


Action 


Ret ur 


Code 


Cond ition 


code 


code 


code 


- 


Successful completion 


— 


— 


-1 


01 


DS2 less than 265 records 


1 


2 


12 


02 


Disk error reading DS1 


2 


2 


12 


03 


End of file reached on DS1 


1 


3 


4 


04 


Disk error reading object 










modu le 


2 


1 


8 


05 


Invalid 'OUTPUT' record 


1 


2 


12 


06 


Invalid 'INCLUDE' record 


1 


6 


8 


07 


Error opening object output 










module : 


1 


5 


12 




- misspelled name or 










volume 










- data set not allocated 








08 


Error opening input object 










module (see Error 07) 


1 


6 


8 


09 


Error opening output module 
( hardware error ) 


2 


5 


12 


10 


Error opening an input 
module (hardware error) 


2 


6 


8 


11 


Error opening autocall list 
(DS9) . See Error 07 for 










causes 


1 


5 


12 


12 


Error opening autocall list 










(DS9) (hardware error) 


2 


5 


12 


13 


Invalid input object module 










record type 


4 


4 


8 


14 


Entry point label not found 


1 


3 


4 


15 


No valid ESDID for TXT or 










RLD 


4 


4 


8 


16 


Invalid ESD item type 


4 


4 


8 


17 


Duplicate ESDID number 


4 


4 


8 


18 


Invalid Symbol 


4 


4 


8 


19 


Duplicate Entry point 










symbo 1 


3 


4 


8 


20 


Invalid ESDID number 


4 


4 


8 


22 


Invalid ESD symbol 


4 


1 


8 



o 
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V> 



SLINK Completion Codes (Part 2 of 3) 



Comp . 






Cause 


Act i on 


Return 


Code 


Condition 




code 


code 


code 


23 


End of file reached on 


DS9 


1 


2 


12 


24 


Disk error reading DS9 




2 


2 


12 


25 


Disk error reading DS4 




2 


2 


12 


26 


End of File reached on 


DS3 


6 


2 


12 


27 


Disk error Read/Write 












on DS8 




2 


2 


12 


28 


End of file reached on 


DS8 


5 


2 


12 


29 


End of file reached on 


DS7 


6 


2 


12 


30 


End of file reached on 


DS4 


6 


2 


12 


31 


Disk error writing on DS5 


2 


2 


12 


32 


End of file reached on 


DS5 


5 


2 


12 


33 


End of file reached on 


DS2 


6 


2 


12 


34 


Duplicate section definition 








(CSECT) 




3 


1 


4 


36 


End of file reached on 


DS6 


4 


1 


8 


37 


Disk error, read/write 


on 










DS7 




2 


2 


12 


38 


Disk error, read/write 


on 










DS3 




2 


2 


12 


39 


Invalid RLD record data 










length 




4 


4 


8 


40 


Disk error, read/write 


on 










DS2 




2 


2 


12 


42 


DS2 not large enough 












(program size over 64K) 


5 


2 


12 


45 


No 'INCLUDE' records 




1 


2 


12 


46 


No CSECT length field 




4 


3 


4 


None 


Unresolved EXTRN 








4 



s~\ 
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$LINK Completion Codes (Part 3 of 3) 



O 



Cause Codes 



1 - 

2 - 

3 - 

4 - 

5 - 

6 - 



Your error 

System error 

Possible duplicate f name , vo 1 ume ' or duplicate CSECT 

or ENTRY names 

Input object record(s) in error. Probable cause is 

that f name , vo lume ' is not a valid object module 

Data set is of insufficient size 

Probable SLINK error, this condition should not 

occur 



Act i on Codes 

1 - Log warning message and continue at next 'INCLUDE 

2 - Terminate $LINK with error message 

3 - Continue as if expected occurance had happened 

4 - Log error message plus invalid object module 

record and continue at next 'INCLUDE" 

5 - Log error message plus OUTPUT record and 

terminate SLINK 

6 - Log error message plus INCLUDE record, continue 

at next 'INCLUDE' 



Return Code Definitions 

-1 Successful completion 
4 Warning: A module has been written 

execution will probably work 
8 Warning: A module has been written 
execution will probably fail 
12 Severe error: Module is not written 



Chapter 6. Messages and Codes 



466.1 



TNL SN34-0762 (December 15, 1981) to SC34-0313-2 



Completion Codies 



$UPDATE Completion Codes 

The $UPDATE completion codes are displayed on the terminal used 
to access $UPDATE. The codes are as follows: 



Complet i on 




Code 


C o n d i t 


-1 


Succes 


8 


No sup 


8 


Output 


8 


Di sk v 


8 


No spa 


. 8 


No spa 


8 


I n v a 1 i 


8 


I n v a 1 i 


8 


Disk v 


8 


Disk v 


8 


L i b r a r 


8 


Input 


8 


No par 


8 


No dat 


8 


Rep lac 


12 


Any d i 



sful completion 

ervisor space in this library 

name specified is not a program 
olume already in use by another program 
ce in directory 

ce in data set (output library) 
d header format 
d program name 
olume not mounted 
ol ume off line 
y not found 
data set not found 
ameter supplied via SJOBUTIL 
a set names provided via $JOBUTIL 
ement of output data set not allowed 
sk or diskette I/O errors 



o 



466.2 



SC34-G313-2 



TNL SN34-0762 (December 15, 1981) to SC34-0313-2 



Return Codies 






EVENT DRIVEN LANGUAGE AND FUNCTION RETURN CODES 



The return codes and their meanings are presented in alphabetic 
order according to function as follows: 



$DISKUT3 

$PDS 

BSC 

Data Formatt i ng 

Disk and Tape (READ/WRITE) 

EXIO 

F loat i ng-po i nt 

Formatted Screen Image as follows: 
$IMDATA subroutine 
$IMOPEN subroutine 
SIMPROT subroutine 

Indexed Access Method 

Multiple Terminal Manager 

SBIO (Sensor Based I/O) 

Terminal I/O as follows: 
Genera 1 
ACCA 

Interprocessor Communications 
Virtual Term i na 1 

TP (Host Communication Facility) 



The return codes are issued by EDL instructions and 
EDL-invokable functions. They are returned in the first word 
of the task control block of the calling program unless other- 
w i se noted . 
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SDISKUT3 Return Codes 

The $DISKUT3 utility places a return code in the first word of 
the DSCB specified. The return codes for $DISKUT3 are listed 
below. 



Return 
Code 



10 
11 

12 

13 
14 
15 
16 
17 

18 

19 
20 
21 



Cond i t i on 



Invalid request code parameter (not 1-6) 

Volume does not exist (All functions) 

Insufficient space in library (ALLOCATE) 

Insufficient space in directory (ALLOCATE) 

Data set already exists - smaller than the 

requested allocation 

Insufficient contiguous space (ALLOCATE) 

Disallowed data set name, eg. SEDXVOL or 

SEDXLIB (All functions) 

Data set not found 

(OPEN, RELEASE, RENAME) 

New name pointer is zero (RENAME) 

Disk is busy 

(ALLOCATE, DELETE, RELEASE, 

I/O error writing to disk 

(ALLOCATE, DELETE, RELEASE, 

I/O error reading from disk 

Data set name is all blanks 

Invalid size specification (ALLOCATE) 

Invalid size specification (RELEASE) 

Mismatched data set type 

(DELETE, OPEN, RELEASE, RENAME) 

Data set already exists - larger than the 

requested allocation 

SETEOD only valid for data set of type "data" 

Load of $DISKUT3 failed ($RMU only) 

Tape data sets are not supported 



RENAME) 

RENAME) 

(All f unct i ons ) 

(ALLOCATE, RENAME) 






\J 
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$PDS Return Codes 

The $PDS utility returns the status of an event in the event 
control block (ECB) specified by the EVENT= parameter on the 
LOAD instruction. The return codes for $PD5 are listed below. 



o 



Return 
Code 



-1 
1 
2 
3 

5 
7 
8 
9 
10 



Cond i t i on 



Successful operation 

Member not found 

Member already allocated 

No space 

D i rectory is full 

Member was not used 

Record not in member 

Member control block invalid 

Space not released 

Not a data member 



13 
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BSC Return Codes 



Return 
Code 



END = 

1 
2 
3 
4 
5 
6 



ERROR= 

10 
11 
12 
13 
14 
15 
20 
21 
22 
23 
24 
25 
30 
31 
32 
33 
34 

35 
99 



Cond i t i on 



Notes 



Text received in conversational mode 
Successful completion 



EOT received 

DLE EOT rece i ved 

Reverse interrupt received 

Forward abort received 

Remote station not ready (NAK received) 

Remote station busy (WACK received) 



Time-out occurred 1 

Unrecovered transmission error (BCC error) 1 

Invalid sequence received 3 

Invalid multi-point tributary write attempt 2 

Disregard this block sequence received 1 

Remote station busy (WACK received) 1 

Wrong length record - long (No COD) 6 

Wrong length record - short (write only) 2 

Invalid buffer address 2 

Buffer length zero 2 

Undefined line address 2 

Line not opened by calling task 2 

Modem interface error 2 

Hardware overrun 2 

Hardware error 5 

Unexpected ring interrupt 2 
Invalid interrupt during auto-answer 

attempt 2 

Enable or disable DTR error 2 

Access method error 2 






Notes: 

1. Retried up to the limit specified in the RETRIES= operand 
of the BSCLINE definition. 

2 . Not ret r i ed . 
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%J 



3. Retried during write operation only when a wrong ACK is 
received following an ENQ request after timeout (indicat- 
ing that no text had been received at the remote station). 

4. Returned only during an initial sequence with no retry 
attempted . 

5. Retried only after an unsuccessful start I/O attempt. 

6. Retried only during read operations. 
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Data Formatting Return Codes 



Return 
Code 



Descr i pt i on 



-1 
1 
2 
3 



Successful completion 
No data in field 
Field om i tted 
Conversion error 



These return codes are issued by the CONVTB, CONVTD, GETEDIT, 
and PUTEDIT instructions. 



/f "N, 
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Disk and Tape (READ/WRITE) Return Codes 

Disk and tape return codes resulting from READ/WRITE 
instructions are returned in two places: 

1. the Event Control Block (ECB) named DSn, where n is the 
number of the data set being referenced. 

2. the task code word referred to by taskname. 

The disk and tape return codes and their meanings are shown 
below. 



o 



If further information concerning an error is required* it may 
be obtained by printing all or part of the contents of the Disk 
Data Blocks (DDBs) located in the Supervisor. The starting 
address of the DDBs can be obtained from the linkage editor map 
of the supervisor. The contents of the DDBs are described in 
the Internal Design . Of particular value are the Cycle Steal 
Status Words and the Interrupt Status Word save areas, along 
with the contents of the word that contains the address of the 
next DDB in storage. 
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Disk Return Codes 



Return 
Code 



-1 
1 



9 
10 

11 

12 



Cond 1 1 i on 



Successful completion 

I/O error and no device status present 

(this code may be caused by the I/O area 

starting at an odd byte address) 

I/O error trying to read device status 

I/O error retry count exhausted 

Read device status I/O instruction error 

Unrecoverable I/O error 

Error on issuing I/O instruction for 

normal I/O 

A 'no record found* condition occurred, 

a seek for an alternate sector was performed, 

and another 'no record found' occurred, 

for example, no alternate is assigned 

Device was 'offline* when I/O was requested 

Record number out of range of data set— may 

be an end-of-file (data set) condition 

Data set not open or device marked unusable 

when I/O was requested 

DSCB was not OPEN; DDB address = 



,^~\ 

o 



Note; The actual number 
second word of the TCB. 



of records transferred is in the 
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TPAE RETURN CODES 






Return 
Code 



-1 
1 
2 

5 
6 
10 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
76 



Condition 



Successful completion 

Exception but no status 

Error reading STATUS 

Error issuing STATUS READ 

Unrecoverable I/O error 

Error issuing I/O command 

Tape mark (EOD) 

Device in use or offline 

Wrong length record 

Not ready 

File protect 

EOT 

Load point 

Uncorrected I/O error 

Attempt WRITE to unexpired data set 

Invalid blksize 

Data set not open 

Incorrect device type or DSCB not open 

Incorrect request type or close request 

Block counter error during close 

EOV1 label encoutnered during close 

DSN not found 



Note* The actual number 
second word of the TCB. 



of records transferred is in the 
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EXIO Return Codes (Part 1 of 2) 



I/O Instruction Return Codes (word of TCB; 
word 1 of TCB contains supervisor instruction 
address ) 



Return 


Code 


-1 


1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


11 


12 


13 


16 



Condition 



Command accepted 

Device not attached 

Busy 

Busy after reset 

Command reject 

Intervention required 

Interface data check 

Control ler busy 

Channel command not allowed 

No DDB found 

Too many DCBs chained 

No address specified for residual status 

EXIODEV specified zero bytes for residual 

status 

Broken DCB chain (program error) 

Device already opened 
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!eturn Code: 



EXIO Return Codes CPart 2 of 2) 



o 



Interrupt Condition Codes (bits 4-7 of word 
(If bit is on. bits 8-15=device ID) 



of ECB) 



Return 
Code 




1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 

12 

13 
14 
15 



Condition 



Cont ro 1 ler end 

Program Controlled Interrupt (PCI) 

Exception 

Device end 

Attention 

Attention and PCI 

Attention and exception 

Attention and device end 

Not used 

Not used 

5E on and 

SE on and 

status 

SE on and 

residual status 

Broken DCB chain 

ECB to be posted not reset 

Error in Start Cycle Steal Status 

(after exception) 



too many DCBs chained 

no address specified for residual 

EXIODEV specified no bytes for 



^r^^ 
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Floating-Point Return Codes 



Return 
Code 



Descr i pt i on 



-1 Successful completion 
1 Floating point overflow 
3 Floating point divide check 

Cdi vide by ' T ) 
5 Floating point underflow 
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Formatted Screen Image Return Codes 

These return codes are issued by the $ I M D A T A > $ I M P E N , and 
SIMPROT subroutines. They are returned in the second word of 
the task control block (TCB) of the calling program. 



$IMDATA — Screen Image Unprotected Fields 



Return 
Code 



Cond i t i on 



-1 
9 



Successful completion 
Invalid format in buffer 



o 



$IMOPEN - Formatted Screen Image 



Return 
Code 



-1 
1 
2 
3 

5 
6 
7 
8 



Condition 



Successful completion 

D i sk I/O error 

Invalid data set name 

Data set not found 

Incorrect header or data set length 

Input buffer too small 

Invalid volume name 

No 3101 image available 

Data set name longer than eight-bytes 
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$IMPROT - Screen Image Protected Fields 



Return 
Code 



Condition 



-1 

9 

10 

11 



Successful completion 

Invalid format in buffer 

FTAB truncated due to insufficient 

buffer s i ze 

Error in building FTAB from 3101 

format; partial FTAB created 
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Return Codes 



INDEXED ACCESS METHOD RETURN CODES 

The following codes indicate that the indexed data set contains 
errors : 



o 



R 


et urn 


C 


ode 




-1 




-57 




-58 




-80 




-85 




01 




07 




08 




10 




12 




13 




14 




22 




23 




50 




51 




52 



54 

55 

56 

60 

61 

62 

70 

80 

35 

90 

100 

101 

110 

120 

122 



Condition 



Success 
Data se 
Record 
End of 
Record 
Funct i o 
Link mo 
Load er 
Invalid 
Data se 
Module 
Invalid 
Invalid 
Get sto 
Data se 
use , ca 
Data s e 
Data se 
opened 
Invalid 
process 
Get sto 
READ er 
Out of 
End of 
Dup 1 i ca 
No s p a c 
FCB WRI 
Key fie 
Key sav 
READ er 
WRITE e 
WRITE e 
Invalid 
In valid 



f u 1 co 
t has 
not f o 
data 
to be 
n code 
dule i 
r or f o 
reque 
t shut 
not i n 
i ndex 
IACB 
rage e 
t i s o 
nnot b 
t open 
t i s o 
e xc lus 
block 
i ng 

rage e 
r or - 
sequen 
file' 
te key 
e for 
TE err 
Id mod 
e area 
r or 
r ror 
r ror - 
extra 
f i le 



m p 1 e t i o n 
been 1 oaded 
und 

deleted not found 

not recognized 
n use 
r $IAM 
st 

down due to error 
eluded to load module 

block found 
address 
rror ~ IACB 
pen for exclusive 
e opened exclusively 
e d in loaclmode 
peneclj cannot be 
i v e 1 y 

size during PROCESS or LOAD 

rror - FCB 

FCB 

ce or duplicate key 

found in process mode 
i nsert 

or during DELETE processing 
ified by user 

in use 



data set closed 
ct type 
for extract type FCBEXT 
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LOAD RETURN CODES 



Return 
Code 



-1 
61 

62 
63 
6 4 
65 



66 

67 

68 
69 
70 
71 
72 

73 

74 
75 
76 

77 
78 

79 

80 
81 

82 



Cond i t i on 



Succes 
The t r 
in the 



In 
In 
No 
In 



an 
an 
spa 

an 



sets p 
equal 
In an 
were p 
A disk 
the lo 
Reser v 
Reser v 
Not en 
Progra 
Disk o 
d i rect 
Disk o 
progra 
Ref er e 
Ref ere 
One of 
volums 
In va 1 i 
LOAD i 
sets ( s 
LOAD i 
parame 
I n v a 1 i 
Cross 
not in 
Reques 
of par 



sful 
ansie 

syst 
o ver 1 
o ver 1 
ce a v 
o v e r 1 
assed 
numbe 
o ver 1 
assed 

or d 
ad pr 
ed 
ed 

ough 
m not 
r d i s 
ory 
r d i s 
m hea 
need 
need 

the 



comp 
nt 1 
em 

ay r 
ay r 
a i la 
ay 1 

by 
r re 
ay 1 

to 
i ske 
oces 



1 e t i o n 

oader (SLOADER) 



is not include 



equest , no over la 
equest> overlay a 
b le for the trans 
oad operation, n u 
the LOAD instruct 
quired by the ove 
oad operation, no 
the loaded progra 
tte I/O error occ 



main storage availabl 

found on the specifi 

kette error while rea 



y area 
rea is 
ient 1 o 

mber of 
ion doe 
r lay pr 
parame 
m 
urred d 



e f or p 
ed vo 1 u 
ding 



ex i sts 
i n use 
ader 

data 
s not 
ogram 
ters 

un'ng 



rogram 
me 



(f 
U 






kette error while reading 

am 
n referenced 



der 

module is not a progr 

module is a data set 

data sets not found oi 



d data set name 

nstruction did not specify required dat 

) 

nstruction did not specify required 

ter ( s ) 

d volume label specified (see note) 

partition LOAD requested; support 

eluded at system generation 

ted partition number greater than numbe 

tition in the system 
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Return Codes 



Notes: 

1. If the program being loaded is a sensor I/O program and a 
sensor I/O error is detected, the return code will be a 
sensor I/O return code, not a load return code. 

2 . Return code 80 will occur if two or more data sets refer- 
ence the same tape volume. 

Multiple Terminal Manager Return Codes 

These return codes are returned in a caller-specified variable 
on the SETPAN, FILEIO, FTAB, or SETFMT function. 



o 



CODE 



DESCRIPTION 



-501 
-500 

-2 

-1 

1 



3 

201 
202 
203 

204 
205 
206 
207 
208 

Other 



Sere 

Term 

no a 

FTAB 

Succ 

Warn 

pane 

unpr 

pos i 

For 

For 

For 

For 

No d 

Data 

Volu 

No f 

all 

I/O 

I/O 

Inva 

Inva 

SEOD 

leng 

Retu 

Inde 



en data 
i na 1 is 
c t i on h 

code n 
essf u 1 
i ng '> Fo 
1 . Inp 
otected 
t i on se 
FTAB, n 
SETPAN, 
FTAB, t 
SETFMT, 
ata str 

set no 
me not 
ile tab 
have up 
error r 
error w 
lid fun 
1 i d key 

record 
th 

rn code 
xed Ace 



set not 

not an I 
as been t 
ot link e 
completio 
r SETPAN, 
ut buffer 

blanks ( 
t to zero 
o f i e Ids 

unprotec 
he FTAB t 

data str 
earn found 
t found 
found 
le ent r i e 
dates out 
ead i ng vo 
r i t i ng vo 
ct i on req 

operator 

number g 



found 

BM 4978/4979 or 3101; 

aken 

dited with application 

n 

this is an uninitilized 

has been set to 
x * 00 ' ) and cursor 

were found . 

ted data is truncated, 
able is truncated, 
earn is truncated. 



s are available; 

stand i ng 

lume d i rectory 

1 ume d i rectory 

uest 

reater than data set 



from READ/WRITE or 
ess Method 



the 



o 
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SBIO (Sensor-based I/O) Return Codes 



Return 
Code 



-1 

90 

91 

92 

93 

94 

95 

96 

97 

98 

100 

101 

102 

104 



Cond i t i on 



Successful completion 

Device not attached 

Device busy or in exclusive use 

Busy after reset 

Command reject 

Invalid request 

Interface data check 

Controller busy 

Analog Input over voltage 

Analog Input invalid range 

Analog Input invalid channel 

Invalid count field 

Buffer previously full or empty 

Delayed command reject 






G 
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Return Codes 



Terminal I/O Return Codes 

These codes are returned by the PRINTEXT, READTEXT, and 
TERMCTRL instructions. The codes differ depending on the type 
of terminal being accessed. Separate tables show general 
codes, ACCA, General Purpose Interface Bus, Interprocesso r 
Communications, Series/1 to Series/1, and Virtual Terminal 
return codes. 



Terminal I/O - General 



O 



Return 
Code 



-1 
1 
2 
3 

5 

6 

7 

>10 



Cond i t i on 



Succ 

Dev i 

Syst 

Syst 

Syst 

Dev i 

Inte 

Over 

Code 

mult 

subt 

r esu 

( num 

er r o 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 

Bit 



ess f 



ce 
em 
em 
em 
ce 



r f ac 
r un 
s gr 
i pie 
r act 
It a 
ber i 
r as 

- 

1 - 

2 - 

3 - 

4 - 

5 - 

6 - 

7 - 



u 1 c 
ot a 
r r or 
r r or 
r ror 
ot r 
e da 
rece 
eate 

err 

10 
s an 
ng f 

fol 
Unus 
Syst 
Not 
Syst 
Stor 
In va 
Stor 
Inte 



omp 1 

ttac 

(bu 

(bu 

( CO 

eady 
ta c 
i ved 
r th 
ors . 
from 
8-b 
rom 
lows 
ed 

em e 
used 
em e 
age 
1 id 
age 
r f ac 



et i on 

hed 

sy condition) 

sy after reset) 

mmand reject) 

heck 

an 10 represent possible 
To determine the errors, 
the code and express the 
it binary value. Each bit 
the left) represents an 



rror (command reject) 

rror (DCB specification check) 
data check 
storage address 
protection check 
e data check 






Note: For 2741 or PROC devices, subtract 128, not 10; the 
result then contains status word 1 of the ACCA. (Refer to 
Communication Features Description to determine the special 
error c o n d ition. ) 
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Terminal I/O - ACCA Return Codes 



Return 
Code 



Bit 



Condition 



Successful completion 



Condition 



Unused 
1-08 ISB of last operation (I/O complete) 
9-10 Unused 

11 1 if a write of control operation 
(I/O compl ete ) 

12 Read operation (I/O complete) 

13 Unused 

14-15 Condition code +1 after I/O start or 
condition code after I/O complete 



\i W 
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o 



Terminal I/O - Interprocessor Communications Return Codes 



CODTYPE 



Return 
Code 



EBCD/CRSP EBCDIC Condition 



-2 IF 

-1 5B 

Handled Not used 

by 

device 

support 



FDFF 
FEFF 
FCFF 



End of transmission (EOT) 

End of record (NL) 

End of subrecord (EOSR) 



Chapter 6. Messages and Codes 466.23 



TNL SN34-0762 (December 15, 1981) to SC34-0313-2 



Return Codes 



Terminal I/O - Virtual Terminal Communications Return Codies 



Va 1 ue 



Tr ansm i t 



Rece i ve 



x*8Fnn f NA 
x»8Enn' NA 
-2 NA 

-1 Successful completion 

1 Not attached 

5 D i sconnect 

8 Break 



LINE=nn received 
SKIP=nn received 
Line received (no CR) 
New line received 
Not attached 
D i sconnect 
Break 



LINE = nn (x T 8Fnn ' ) : This code is posted for .READTEXT or 
GETVALUE instructions if the other side sent the LINE forms 
control operation; it is transmitted so that the receiving pro- 
gram may reproduce on a real terminal (for printer spooling 
applications for example) the output format intended by the 
sending program. 

SKIP=nn ( x ' 8Enn T ) : The sending program transmitted SKIP = nn. 

L i ne Rece i ved ( — 2 ) : This code indicated that the sending pro- 
gram did not send a new line indication, but that the line was 
transmitted because of execution of a control operation or a 
transition to the read state. This is how, for example, a 
prompt message is usually transmitted with READTEXT or 
GETVALUE. 



4 X 



New Line Received (— 1 ) : This code indicates transmission of 
the carriage return at the end of the data. The distinction 
between a new line transmission and a simple line transmission 
is, again, made only to allow preservation of the original out- 
put format. 



Not attached (1): 



operation does 

this code is returned. 



If the virtual terminal accessed for the 
not reference another virtual terminal, then 



Disconnect (5) : This code value corresponds to the 'not ready" 
indication for real terminals; its specific meaning for virtu- 
al terminals is that the program at the other end of the channel 
terminated either through PROGSTOP or operator intervention. 

Break (8 ) : The break code indicates that the other side of the 
channel is in a state (transmit or receive) which is incompat- 
ible with the attempted operation. If only one end of the chan- 
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Return Code: 



nel is defined with SYNC=YES (on the TERMINAL statement), then 
the task on that end will always receive the break code, wheth- 
er or not it attempted the operation first. If both ends are 
defined with SYNC=YES, then the code will be posted to the task 
which last attempted the operation. The break code may thus be 
understood as follows? when reading (READTEXT or GETVALUE), 
the other program has stopped sending and is waiting for input; 
when writing (PRINTEXT or PRINTNUM), the other program is also 
attempting to write. Note that current Event Driven Executive 
programs, or future programs which do not interpret the break 
code, must always communicate through a virtual terminal which 
is defined with SYNC=NO (the default). 



o 
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TP (Host Communication Facility) Return Codes (Part 1 of 3) 



Return 
Code 



7 
8 

9 
10 

11 

50 
51 



100 
101 
102 



Cond i t i on 



Successful completion 

Illegal command sequence 

TP I/O error 

TP I/O error on host 

Looping bidding for the line 

Host acknowledgement to Supervisor 

request code was neither ACK0, 

ACK1, WACK, or a NACK 

Retry count exhausted - last 

error was a timeout: the host 

must be down 

Looping while reading data from 

the host 

The host responded with other 

thanan EOT or an ENQ when an 

EOT was expected 

Retry count exhausted - last error 

was a modem interface check 

Retry count exhausted - last error 

was not a timeout, modem check, 

block check, or overrun 

Retry count exhausted - last error 

was a transmit overrun 

I/O error from last I/O in DSWRITE 

I/O error when writing the last 

buffer 



Length of DSNAME is zero 
Length of DSNAME exceeds 52 
Invalid length specified for 



I/O 



Module 



Super visor 
Super visor 
Supervi sor 
HCFCOMM 
Supervisor 



Super v i sor 

Super v i sor 
Super v i sor 

Supervisor 
Supervisor 

Super visor 

DSCLOSE 
DSCLOSE 



HCFCOMM 
HCFCOMM 
HCFINIT 






\jr 
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TP (Host Communication Facility) Return Codes (Part 2 of 3) 



O 



Return 
Code 



200 

201 
202 

203 

204 
205 

2 06 

207 
208 
209 
211 
212 
213 
214 
216 

217 

218 
219 
220 

221 
222 



Condition 



Modu le 



Data set not on volume specified HCFINIT 

for controller 

Invalid member name specification DSOPEN 

Data set in use by another job DSOPEN 

Data set already allocated to 

this task DSOPEN 

Data set is not cataloged DSOPEN 

Data set resides on multiple 

volumes DSOPEN 

Data set is not on a direct access 

device DSOPEN 

Volume not mounted (archived) DSOPEN 

Device not online DSOPEN 

Data set does not exist DSOPEN 

Record format is not supported DSOPEN 

Invalid logical record length DSOPEN 

Invalid block size DSOPEN 

Data set has no extents DSOPEN 

Data set organization is partitioned 

and no member name was specified DSOPEN 

Data set organization is sequential 

and a member name was specified DSOPEN 

Error during OS/ OPEN DSOPEN 

The specified member was not found DSOPEN 

An I/O error occurred during a 

directory search DSOPEN 

Invalid data set organization DSOPEN 

Insufficient I/O buffer space 

available DSOPEN 



300 End of an input. data set 

301 I/O error during an OS/ READ 

302 Input data set is not open 

303 A previous error has occurred 



DSREAD 
DSREAD 
DSREAD 
DSREAD 
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TP (Host Communication Facility) Return Codes (Part 3 of 3) 



Return 
Code 



Cond i 1 1 on 



400 End of an output data set 

401 I/O error during an OS/ WRITE 

402 Output data set is not open 

403 A previous error has occurred 

404 Partitioned data set is full 



800 Index and key exist 

801 Index does not exist 

802 Key does not exist 
810 I/O error 



900 Index and/or key released 

901 Index does not exist 

902 Key does not exist 
910 I/O error 



lxxx An error occurred in a subordinate 
module during SUBMIT. 'xxx* is 
the code returned by that module. 



Module 



DSWRITE 
DSWRITE 
DSNRITE 
DSWRITE 
DSCLOSE 



700 Index* key, and status record added SET 

701 Index exists, key and status added SET 

702 Index and key exist, status replaced SET 

703 Error - Index full SET 

704 Error - Data set full SET 
710 I/O Error SET 



FETCH 
FETCH 
FETCH 
FETCH 



RELEASE 
RELEASE 
RELEASE 
RELEASE 



S7SUBMIT 



/if ^ 
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Post Codes 



EVENT DRIVEN LANGUAGE AND FUNCTION POST CODES 



The Event Driven language and function post codes are returned 
to the first word of the event control block (ECB) (unless 
stated otherwise) to signal the occurrence of an event. 
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Tape Post Codes 

If you initialize a tape by loading STAPEIT from a program or by 
invoking OJOBUTIL and passing the above parameters, the fol- 
lowing post codes are returned to the event control block (ECB) 
of the calling program. 



Post Code 



Cond i t i on 



-1 
RC 
101 
102 
103 
104 



Function successful 

Any tape I/O return code 

TAPEID not found 

De v i ce no offline 

Unexpired data set on tape 

Cannot initialize BLP tapes 
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